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

Responder a uma avaliação

Publica a resposta do proprietário a uma avaliação ou a substitui: uma avaliação tem uma única resposta, então uma segunda chamada edita a primeira (o Google a atualiza; no Facebook, nosso comentário de resposta é editado). pushed: false significa que a resposta ainda não está no ar: ou a plataforma a aceitou e ainda está publicando (status pending), ou a plataforma não tem API de resposta e ela ficou salva apenas na Synup. Falha com 422 se não for possível responder à avaliação ou se a plataforma a recusou; retryable indica se tentar de novo pode dar certo.

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 está no ar na plataforma de origem. False enquanto a plataforma ainda a publica (status pending), ou quando a plataforma não tem API de resposta e a resposta fica salva apenas na Synup.
statusstring (posted | pending | failed | draft)opcional
Um de: posted, pending, failed, draft.
externalReplyIdstringopcional
O id da resposta na plataforma de origem, ou null.
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