API Bình luận & Phản hồi

Các tính năng bình luận phụ thuộc vào phạm vi khả năng của nền tảng SNS được kết nối và các quyền hiện tại của tài khoản.

Các điểm cuối bình luận

Phương thức	Đường dẫn	Mục đích
`GET`	`/v1/brand/comments`	Danh sách bình luận
`GET`	`/v1/brand/comments/{comment_id}`	Lấy chi tiết bình luận
`POST`	`/v1/brand/comments`	Đăng một bình luận cấp cao nhất trên một bài viết
`POST`	`/v1/brand/comment-refresh-jobs`	Yêu cầu làm mới bình luận
`GET`	`/v1/brand/comment-refresh-jobs/{id}`	Kiểm tra trạng thái công việc làm mới
`POST`	`/v1/brand/comments/{comment_id}/moderation-actions`	Yêu cầu hành động ẩn hoặc xóa

Đăng một bình luận cấp cao nhất:

{
  "idempotency_key": "comment-001",
  "target": { "content_id": "<content_id>" },
  "text": "Thank you for checking out our post."
}

Các giá trị action hiện tại cho việc kiểm duyệt là hide hoặc delete. Việc thực hiện thực tế phụ thuộc vào nền tảng và trạng thái bình luận.

Các công việc phản hồi

Phương thức	Đường dẫn	Mục đích
`POST`	`/v1/brand/reply-jobs`	Tạo công việc phản hồi
`GET`	`/v1/brand/reply-jobs`	Danh sách các công việc phản hồi
`GET`	`/v1/brand/reply-jobs/{reply_job_id}`	Lấy trạng thái công việc phản hồi

{
  "comment_id": "<comment_id>",
  "idempotency_key": "reply-001",
  "text": "Thank you for reaching out."
}

Mã HTTP 202 khi tạo phản hồi có nghĩa là công việc đã được xác minh, lưu trữ và đưa vào hàng đợi. Hãy xác minh trạng thái cuối cùng thông qua reply_job_id.

Trạng thái Khả dụng & Phục hồi

Các phản hồi có thể bao gồm các chỉ báo khả dụng và phục hồi sau:

permission_required: Thiếu quyền yêu cầu; có thể phục hồi thông qua việc xác thực lại
permission_unverified: Trạng thái quyền không thể được xác định chắc chắn
review_disabled: Tính năng bị vô hiệu hóa theo các chính sách xét duyệt ứng dụng hiện tại
unsupported: Nền tảng không hỗ trợ hoạt động này
reauthorize: Xác thực lại kết nối SNS
contact_support: Yêu cầu liên hệ hỗ trợ

🔗 Tài liệu liên quan