Synup
Créer une clé
v1Ressources/Reviews/postRépondre à un avis

Répondre à un avis

Publie une réponse de l'entreprise à un avis et la transmet à la plateforme source. Échoue avec une erreur de règle métier (422) si l'avis ne peut pas recevoir de réponse — par ex. parce qu'il a été retiré de sa source.

post/api/v1/reviews/reply
reviews:write
Corps de la requête
reviewIdstringobligatoire
L'avis auquel répondre. Obligatoire.
textstringobligatoire
Le texte de la réponse à publier. Obligatoire.
Réponse
dataobjectfacultatif
okbooleanfacultatif
Si la réponse a été acceptée.
pushedbooleanfacultatif
Si la réponse a réellement été transmise à la plateforme source (plutôt que mise en file d'attente).
statusstring (posted | pending | failed | draft)facultatif
L'une des valeurs : posted, pending, failed, draft.
externalReplyIdstringfacultatif
L'id de la réponse sur la plateforme source, ou null.
retryablebooleanfacultatif
En cas d'échec de la transmission, si une nouvelle tentative pourrait réussir — null si non applicable.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
422Il manque un paramètre requis à la requête, ou elle est invalide.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/reviews/reply
Votre clé API
Corps de la requête*
{
  "data": {
    "ok": true,
    "pushed": true,
    "status": "posted",
    "externalReplyId": "ext_reply_123",
    "retryable": null
  }
}

Guides qui utilisent cet endpoint