API des commentaires et réponses
Les fonctionnalités disponibles pour les commentaires dépendent du réseau social connecté et des autorisations actuelles du compte.
Points de terminaison des commentaires
Section intitulée « Points de terminaison des commentaires »| Méthode | Chemin | Objectif |
|---|---|---|
GET | /v1/brand/comments | Lister les commentaires |
GET | /v1/brand/comments/{comment_id} | Obtenir les détails d’un commentaire |
POST | /v1/brand/comments | Publier un commentaire de premier niveau sur une publication |
POST | /v1/brand/comment-refresh-jobs | Demander une actualisation des commentaires |
GET | /v1/brand/comment-refresh-jobs/{id} | Vérifier le statut de la tâche d’actualisation |
POST | /v1/brand/comments/{comment_id}/moderation-actions | Demander une action de masquage ou de suppression |
Publication d’un commentaire de premier niveau :
{ "idempotency_key": "comment-001", "target": { "content_id": "<content_id>" }, "text": "Thank you for checking out our post."}Les valeurs actuelles d’action pour la modération sont hide (masquer) ou delete (supprimer). L’exécution réelle dépend de la plateforme et de l’état du commentaire.
Tâches de réponse (Reply Jobs)
Section intitulée « Tâches de réponse (Reply Jobs) »| Méthode | Chemin | Objectif |
|---|---|---|
POST | /v1/brand/reply-jobs | Créer une tâche de réponse |
GET | /v1/brand/reply-jobs | Lister les tâches de réponse |
GET | /v1/brand/reply-jobs/{reply_job_id} | Obtenir le statut d’une tâche de réponse |
{ "comment_id": "<comment_id>", "idempotency_key": "reply-001", "text": "Thank you for reaching out."}Un code HTTP 202 lors de la création d’une réponse signifie que la tâche a été validée, stockée et mise en file d’attente. Vérifiez le statut final via reply_job_id.
États de disponibilité et de récupération
Section intitulée « États de disponibilité et de récupération »Les réponses peuvent inclure les indicateurs de disponibilité et de récupération suivants :
permission_required: Permission requise manquante ; peut être récupérée via une ré-authentificationpermission_unverified: Le statut de la permission ne peut être déterminé de manière concluantereview_disabled: La fonctionnalité est désactivée selon les politiques actuelles de révision de l’applicationunsupported: La plateforme ne prend pas en charge cette opérationreauthorize: Ré-authentifiez la connexion au réseau socialcontact_support: Contact du support requis