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

Répondre à un avis

Publie la réponse du propriétaire à un avis, ou la remplace : un avis a une seule réponse, donc un second appel modifie la première (Google la met à jour ; sur Facebook, notre commentaire de réponse est modifié). pushed: false signifie que la réponse n'est pas encore en ligne : soit la plateforme l'a acceptée et la publie encore (status pending), soit la plateforme n'a pas d'API de réponse et elle est enregistrée dans Synup uniquement. Échoue avec 422 si l'on ne peut pas répondre à l'avis ou si la plateforme l'a refusée ; retryable indique si une nouvelle tentative peut réussir.

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
Indique si la réponse est en ligne sur la plateforme d'origine. False tant que la plateforme la publie encore (status pending), ou lorsque la plateforme n'a pas d'API de réponse et que la réponse est enregistrée dans Synup uniquement.
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.
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