ข้ามไปยังเนื้อหา

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 ตรวจสอบสถานะสุดท้าย

การตอบกลับอาจมีตัวบ่งชี้ความพร้อมใช้งานและการกู้คืนต่อไปนี้:

  • permission_required: ขาดสิทธิ์ที่จำเป็น สามารถแก้ไขได้โดยการยืนยันตัวตนใหม่
  • permission_unverified: ไม่สามารถระบุสถานะสิทธิ์ได้อย่างแน่ชัด
  • review_disabled: ฟีเจอร์ถูกปิดใช้งานภายใต้นโยบายการตรวจสอบแอปในปัจจุบัน
  • unsupported: แพลตฟอร์มไม่รองรับการดำเนินการนี้
  • reauthorize: โปรดยืนยันตัวตนการเชื่อมต่อ SNS ใหม่
  • contact_support: จำเป็นต้องติดต่อฝ่ายสนับสนุน