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

Auf eine Bewertung antworten

Veröffentlicht eine Antwort des Unternehmens auf eine Bewertung und übermittelt sie an die Quellplattform. Schlägt mit einem Geschäftsregel-Fehler (422) fehl, wenn auf die Bewertung nicht geantwortet werden kann — z. B. weil sie aus ihrer Quelle entfernt wurde.

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 tatsächlich an die Quellplattform übertragen wurde (statt nur in die Warteschlange gestellt).
statusstring (posted | pending | failed | draft)optional
Einer von: posted, pending, failed, draft.
externalReplyIdstringoptional
Die ID der Antwort auf der Quellplattform, oder null.
retryablebooleanoptional
Falls die Übertragung fehlgeschlagen ist, ob ein erneuter Versuch erfolgreich sein könnte — null, wenn nicht zutreffend.
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