टिप्पणियाँ और उत्तर (Comments & Replies) API

टिप्पणी सुविधाएँ जुड़े हुए SNS प्लेटफॉर्म की क्षमता स्कोप और वर्तमान खाता अनुमतियों पर निर्भर करती हैं।

टिप्पणी एंडपॉइंट्स (Comment Endpoints)

विधि	पाथ	उद्देश्य
`GET`	`/v1/brand/comments`	टिप्पणियों को सूचीबद्ध करें
`GET`	`/v1/brand/comments/{comment_id}`	टिप्पणी विवरण प्राप्त करें
`POST`	`/v1/brand/comments`	पोस्ट पर एक शीर्ष-स्तरीय (top-level) टिप्पणी पोस्ट करें
`POST`	`/v1/brand/comment-refresh-jobs`	टिप्पणी रिफ्रेश का अनुरोध करें
`GET`	`/v1/brand/comment-refresh-jobs/{id}`	रिफ्रेश जॉब की स्थिति जांचें
`POST`	`/v1/brand/comments/{comment_id}/moderation-actions`	छुपाने (hide) या हटाने (delete) की कार्रवाई का अनुरोध करें

शीर्ष-स्तरीय टिप्पणी पोस्ट करना:

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

मॉडरेशन के लिए वर्तमान action मान hide या delete हैं। वास्तविक निष्पादन प्लेटफॉर्म और टिप्पणी की स्थिति पर निर्भर करता है।

उत्तर कार्य (Reply Jobs)

विधि	पाथ	उद्देश्य
`POST`	`/v1/brand/reply-jobs`	उत्तर कार्य (reply job) बनाएँ
`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 का अर्थ है कि जॉब सत्यापित, संग्रहीत और कतारबद्ध (queued) कर दिया गया था। reply_job_id के माध्यम से अंतिम स्थिति सत्यापित करें।

उपलब्धता और रिकवरी स्थितियाँ (Availability & Recovery States)

प्रतिक्रियाओं में निम्नलिखित उपलब्धता और रिकवरी संकेतक शामिल हो सकते हैं:

permission_required: आवश्यक अनुमति अनुपस्थित है; पुन: ऑथेंटिकेशन के माध्यम से रिकवर किया जा सकता है
permission_unverified: अनुमति की स्थिति निश्चित रूप से निर्धारित नहीं की जा सकती
review_disabled: वर्तमान ऐप समीक्षा नीतियों के तहत सुविधा अक्षम है
unsupported: प्लेटफॉर्म इस ऑपरेशन का समर्थन नहीं करता है
reauthorize: SNS कनेक्शन को पुन: ऑथेंटिकेट करें
contact_support: सपोर्ट से संपर्क करना आवश्यक है

🔗 संबंधित दस्तावेज़