댓글과 답글 API

댓글 기능은 연결된 SNS의 지원 범위와 현재 계정 권한에 따라 달라집니다.

댓글 엔드포인트

메서드	경로	용도
`GET`	`/v1/brand/comments`	댓글 목록
`GET`	`/v1/brand/comments/{comment_id}`	댓글 조회
`POST`	`/v1/brand/comments`	게시물에 최상위 댓글 작성
`POST`	`/v1/brand/comment-refresh-jobs`	댓글 새로고침 요청
`GET`	`/v1/brand/comment-refresh-jobs/{id}`	새로고침 상태 확인
`POST`	`/v1/brand/comments/{comment_id}/moderation-actions`	숨김 또는 삭제 요청

최상위 댓글 작성 예시:

{
  "idempotency_key": "comment-001",
  "target": { "content_id": "<content_id>" },
  "text": "게시물을 확인했습니다."
}

조정 요청의 현재 action 값은 hide 또는 delete입니다. 실제 지원 여부는 SNS와 댓글 상태에 따라 결정됩니다.

메서드	경로	용도
`POST`	`/v1/brand/reply-jobs`	답글 작업 생성
`GET`	`/v1/brand/reply-jobs`	답글 작업 목록
`GET`	`/v1/brand/reply-jobs/{reply_job_id}`	답글 상태 확인

{
  "comment_id": "<comment_id>",
  "idempotency_key": "reply-001",
  "text": "문의해 주셔서 감사합니다."
}

답글 생성의 HTTP 202는 작업이 검증, 저장, 예약되었다는 뜻입니다. reply_job_id로 최종 상태를 확인하세요.

응답에는 다음과 같은 availability와 recovery 정보가 포함될 수 있습니다.