留言與回覆 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": "Thank you for checking out our post."
}

目前審核的 action 值為 hide 或 delete。實際執行情況取決於平台和留言狀態。

方法	路徑	用途
`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": "Thank you for reaching out."
}

建立回覆時傳回 HTTP 202，表示作業已通過驗證、儲存並進入佇列。請使用 reply_job_id 確認最終狀態。

回應可能包含下列可用性與復原指標：