Aller au contenu

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.

MéthodeCheminObjectif
GET/v1/brand/commentsLister les commentaires
GET/v1/brand/comments/{comment_id}Obtenir les détails d’un commentaire
POST/v1/brand/commentsPublier un commentaire de premier niveau sur une publication
POST/v1/brand/comment-refresh-jobsDemander 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-actionsDemander 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.

MéthodeCheminObjectif
POST/v1/brand/reply-jobsCréer une tâche de réponse
GET/v1/brand/reply-jobsLister 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.

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é-authentification
  • permission_unverified : Le statut de la permission ne peut être déterminé de manière concluante
  • review_disabled : La fonctionnalité est désactivée selon les politiques actuelles de révision de l’application
  • unsupported : La plateforme ne prend pas en charge cette opération
  • reauthorize : Ré-authentifiez la connexion au réseau social
  • contact_support : Contact du support requis