Resposta do seller
Cria, edita e remove a resposta pública do seller a uma avaliação.
Responder uma avaliação
Cria a resposta pública do seller a uma avaliação, em nome do seller dono do produto. Se a avaliação já tem resposta, o texto é substituído (o seller original é mantido). O produto precisa ter um seller; produtos da própria loja, sem seller, não aceitam resposta.
/api/v1/admin/reviews/{id}/vendor-replyAdminEscreve a resposta do seller a uma avaliação
Rota ligada ao módulo product-reviews: com o módulo desligado a resposta é 403. Leitura exige manage_content ou view_content; escrita exige manage_reviews ou manage_content.
Parâmetros de caminho
iduuidobrigatórioCorpo da requisição
reply_textstringobrigatórioExemplo de requisição (Responder)
Resposta (Responder)
Campos da resposta
iduuidreview_iduuidvendor_iduuidvendor_namestringreply_textstringreplied_atstringErros (Responder)
| Status | Quando | Exemplo de corpo |
|---|---|---|
| 401 | Token ausente, inválido ou expirado. | {"error":"invalid or expired token"} |
| 403 | O administrador não tem o privilégio exigido. | {"error":"insufficient privileges","privilege_required_any":["manage_reviews","manage_content"]} |
| 400 | reply_text ausente ou vazio, ou o produto da avaliação não tem seller. | {"error":"reply_text is required"} |
| 404 | Avaliação inexistente. | {"error":"review not found"} |
Editar a resposta do seller
Edita o texto da resposta do seller, por exemplo para moderar um conteúdo impróprio. Falha se a avaliação ainda não tem resposta.
/api/v1/admin/reviews/{id}/vendor-replyAdminAltera o texto de uma resposta existente
Rota ligada ao módulo product-reviews: com o módulo desligado a resposta é 403. Leitura exige manage_content ou view_content; escrita exige manage_reviews ou manage_content.
Parâmetros de caminho
iduuidobrigatórioCorpo da requisição
reply_textstringobrigatórioExemplo de requisição (Editar resposta)
Resposta (Editar resposta)
Campos da resposta
iduuidreview_iduuidvendor_iduuidvendor_namestringreply_textstringreplied_atstringErros (Editar resposta)
| Status | Quando | Exemplo de corpo |
|---|---|---|
| 401 | Token ausente, inválido ou expirado. | {"error":"invalid or expired token"} |
| 403 | O administrador não tem o privilégio exigido. | {"error":"insufficient privileges","privilege_required_any":["manage_reviews","manage_content"]} |
| 400 | reply_text ausente ou vazio. | {"error":"reply_text is required"} |
| 404 | A avaliação não tem resposta. | {"error":"vendor reply not found"} |
Apagar a resposta do seller
Remove a resposta pública do seller à avaliação. É idempotente: responde 204 haja ou não resposta.
/api/v1/admin/reviews/{id}/vendor-replyAdminRemove a resposta do seller
Rota ligada ao módulo product-reviews: com o módulo desligado a resposta é 403. Leitura exige manage_content ou view_content; escrita exige manage_reviews ou manage_content.
Parâmetros de caminho
iduuidobrigatórioExemplo de requisição (Apagar resposta)
Resposta (Apagar resposta)
Corpo vazio.
Erros (Apagar resposta)
| Status | Quando | Exemplo de corpo |
|---|---|---|
| 401 | Token ausente, inválido ou expirado. | {"error":"invalid or expired token"} |
| 403 | O administrador não tem o privilégio exigido. | {"error":"insufficient privileges","privilege_required_any":["manage_reviews","manage_content"]} |
| 500 | id que não é UUID, ou falha de banco. | {"error":"failed to delete vendor reply","detail":"..."} |