문서

답글과 지표

글 아래 댓글을 읽고, 답하고, 숨기고, 반응 숫자를 확인해요.

답글은 워크스페이스가 아니라 글 하나에 딸려 있어요. 이 페이지의 호출은 모두 글을 발행과 같은 방식으로 받아요. POST /v1/posts가 준 발행 id, 채널이 준 글 id, 인코딩한 글 링크 중 아무거나 넣으면 돼요.

GET /v1/posts/{id}/replies

올린 글 아래에 달린 답글 스레드를 가져와요.

POST /v1/posts/{id}/replies

글에 답글을 달거나, 그 아래 답글에 다시 답해요.

이름	타입	설명
`content` (필수)	string	답글 내용
`replyTo`	string	스레드에 있는 답글 id 또는 그 댓글 링크. 빼면 원글에 답해요.
`wait`	boolean	답글이 올라갈 때까지 최대 10초 응답을 기다려요. 끝나면 200과 글을, 시간이 넘으면 202와 `next`를 줘요.

대댓글

replyTo를 빼면 원글에 답해요. 답글 id를 넣으면 그 답글 아래에 한 단계 더 들어가서 답해요. 엔드포인트를 따로 두지 않고 같은 호출 하나로 두 경우를 다 처리해요.

원글에 답할 때는 이렇게 보내요.

curl -X POST https://api.posendy.com/v1/posts/post_01H.../replies \
  -H "authorization: Bearer $POSENDY_KEY" \
  -H "content-type: application/json" \
  -d '{"content":"Thanks for reading"}'

답글에 한 단계 아래로 답할 때는 replyTo를 넣어요.

curl -X POST https://api.posendy.com/v1/posts/post_01H.../replies \
  -H "authorization: Bearer $POSENDY_KEY" \
  -H "content-type: application/json" \
  -d '{"content":"Good question","replyTo":"17901234567890123"}'

다른 사람 글에 하는 활동

블로그는 다른 사람 글에 댓글을 달고, 공감을 누르고, 이웃을 맺으면서 커져요. 아래 세 호출은 대상 글을 ownerHandle과 externalId로 받아요. 네이버는 블로그 id와 링크에 있는 logNo를 넣어요. 내 글이면 postId만 넣어도 돼요.

행동하는 쪽은 항상 내가 연결한 계정이고, ownerHandle은 상대 계정이에요.
지금은 네이버 블로그만 돼요. 발행과 마찬가지로 브라우저 확장이 내 브라우저에서 처리해요.
네이버 공감은 누를 때마다 켜지고 꺼져요. 그래서 포샌디는 상태를 먼저 읽고, 이미 켜진 공감은 끄지 않아요.
내 글에 내가 공감하면 네이버가 조용히 무시해서 naver_not_allowed로 돌아와요.

POST /v1/engagement/like

글이나 그 아래 댓글에 공감을 눌러요. 여러 번 불러도 결과가 같고, 공감 취소는 없어요.

이름	타입	설명
`postId`	string	내가 올린 글. 아니면 `ownerHandle`과 `externalId`를 넣어요.
`ownerHandle`	string	글 주인. 네이버 블로그는 블로그 id예요.
`externalId`	string	채널에서의 글 id. 네이버 블로그는 링크의 `logNo`예요.
`replyId`	string	글 대신 이 답글에 공감할 때 넣는 답글 id
`accountId`	string	공감을 누를 연결 계정. 그 채널에 계정이 둘 이상일 때만 필요해요.

POST /v1/engagement/reply

내 글이 아닌 글에 댓글을 달아요(네이버 블로그). 발행 기록은 만들지 않아요.

이름	타입	설명
`ownerHandle` (필수)	string	글 주인
`externalId` (필수)	string	채널에서의 글 id
`content` (필수)	string	댓글 내용
`replyId`	string	글 대신 이 댓글 아래에 달 때 넣어요.
`secret`	boolean	네이버 블로그: 블로그 주인만 볼 수 있는 비밀 댓글

POST /v1/engagement/follow

계정을 팔로우해요(네이버 블로그는 이웃추가). mutual을 켜면 상대가 수락해야 맺어지는 서로이웃 신청을 보내요.

이름	타입	설명
`ownerHandle` (필수)	string	팔로우할 계정. 네이버 블로그는 블로그 id예요.
`mutual`	boolean	네이버 블로그: 서로이웃 신청으로 보내요. 상대가 수락할 때까지 `pending`으로 와요.
`message`	string	서로이웃 신청과 같이 보낼 메시지. 500자까지
`accountId`	string	팔로우할 연결 계정

GET /v1/naver/neighbors/candidates

한 주제로 최근 글을 쓴 블로그를 찾아요. 이 계정과 이미 이어진 블로그는 빼고 보여 줘요. 네이버 블로그 전용이고, 아무것도 보내지 않아요.

이름	타입	설명
`query` (필수)	string	주제, 1~100자. 서버가 네이버 블로그 검색에서 이 주제의 최신 글을 찾아 블로그별로 묶어요.
`mutual` (필수)	boolean	follow로 보낼 신청 종류. true면 서로이웃, 이미 보낸 신청, 거절한 곳을 빼고 한쪽 이웃은 남겨요. false면 전혀 이어지지 않은 블로그만 남겨요.
`days`	number	오늘부터 며칠 안에 그 주제로 글을 쓴 블로그만 남길지. 1~30, 기본 30
`accountId`	string	비교할 연결된 네이버 블로그. 둘 이상일 때만 필요해요.

POST /v1/replies/{replyId}/hide

채널에서 답글을 숨기거나 다시 보이게 해요.

이름	타입	설명
`postId` (필수)	string	그 답글이 달린 글
`hide`	boolean	true면 숨기고 false면 다시 보여요. 기본 true

DELETE /v1/replies/{replyId}

댓글을 완전히 지워요. 숨기기와 달리 되돌릴 수 없어요. 어느 채널에서 되는지는 GET /v1/platforms의 features에서 확인해요.

이름	타입	설명
`postId` (필수)	string	그 답글이 달린 글

GET /v1/posts/{id}/insights

조회, 좋아요, 답글, 리포스트, 인용, 공유 숫자를 가져와요.

{
  "views": 1240,
  "likes": 38,
  "replies": 6,
  "reposts": 2,
  "quotes": 1,
  "shares": null
}

null은 0이 아니에요. 채널이 아직 숫자를 세지 않았으면 조회와 공유가 null로 와요. 이 값을 0으로 그리면 아무도 안 본 것처럼 보이게 돼요. null은 "아직 모름"으로 표시해요.

자주 묻는 것

내 글에 답글을 달려면요?

발행 id로 reply를 부르고 replyTo는 비워 둬요. 그러면 원글에 답글이 달리고 스레드가 시작돼요.

답글에 답글을 달려면요?

같은 호출에 그 답글의 id를 replyTo로 넣어요. 엔드포인트 하나로 두 단계를 다 처리해요.

어떤 숫자를 볼 수 있어요?

조회, 좋아요, 답글, 리포스트, 인용, 공유예요. 채널이 아직 세는 중이면 null로 와요. null은 0이 아니라 아직 모른다는 뜻이에요. 다음은 미디어로 넘어가요.

이전발행 다음미디어