Synup
Criar chave
v1Recursos/Reviews/postResponder a uma avaliação

Responder a uma avaliação

Publica uma resposta da empresa a uma avaliação e a envia à plataforma de origem. Falha com um erro de regra de negócio (422) se a avaliação não puder ser respondida — ex.: porque foi removida de sua fonte.

post/api/v1/reviews/reply
reviews:write
Corpo da solicitação
reviewIdstringobrigatório
A avaliação a ser respondida. Obrigatório.
textstringobrigatório
O texto da resposta a ser publicada. Obrigatório.
Resposta
dataobjectopcional
okbooleanopcional
Se a resposta foi aceita.
pushedbooleanopcional
Se a resposta foi realmente enviada à plataforma de origem (em vez de apenas colocada na fila).
statusstring (posted | pending | failed | draft)opcional
Um de: posted, pending, failed, draft.
externalReplyIdstringopcional
O id da resposta na plataforma de origem, ou null.
retryablebooleanopcional
Se o envio falhou, se uma nova tentativa poderia ter sucesso — null quando não aplicável.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/reviews/reply
Sua chave de API
Corpo da solicitação*
{
  "data": {
    "ok": true,
    "pushed": true,
    "status": "posted",
    "externalReplyId": "ext_reply_123",
    "retryable": null
  }
}

Guias que usam este endpoint