Synup
Schlüssel erstellen
v1Ressourcen/Reviews/postAuf eine Bewertung antworten

Auf eine Bewertung antworten

Veröffentlicht die Antwort des Inhabers auf eine Bewertung oder ersetzt sie: Eine Bewertung hat eine Antwort, ein zweiter Aufruf bearbeitet also die erste (Google aktualisiert sie; bei Facebook wird unser Antwortkommentar bearbeitet). pushed: false bedeutet, dass die Antwort noch nicht live ist: Entweder hat die Plattform sie angenommen und veröffentlicht sie noch (status pending), oder die Plattform hat keine Antwort-API und sie ist nur in Synup gespeichert. Schlägt mit 422 fehl, wenn auf die Bewertung nicht geantwortet werden kann oder die Plattform sie abgelehnt hat; retryable gibt an, ob ein erneuter Versuch gelingen kann.

post/api/v1/reviews/reply
reviews:write
Anfragetext
reviewIdstringerforderlich
Die Bewertung, auf die geantwortet werden soll. Erforderlich.
textstringerforderlich
Der zu veröffentlichende Antworttext. Erforderlich.
Antwort
dataobjectoptional
okbooleanoptional
Ob die Antwort akzeptiert wurde.
pushedbooleanoptional
Ob die Antwort auf der Quellplattform live ist. False, solange die Plattform sie noch veröffentlicht (status pending), oder wenn die Plattform keine Antwort-API hat und die Antwort nur in Synup gespeichert ist.
statusstring (posted | pending | failed | draft)optional
Einer von: posted, pending, failed, draft.
externalReplyIdstringoptional
Die ID der Antwort auf der Quellplattform, oder null.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/reviews/reply
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "ok": true,
    "pushed": true,
    "status": "posted",
    "externalReplyId": "ext_reply_123",
    "retryable": null
  }
}

Anleitungen, die diesen Endpunkt verwenden