Avaliações de produtos
Veja as avaliações dos clientes sobre os produtos do seller, responda publicamente e modere.
Depois de receber um pedido, o cliente pode avaliar cada produto com nota de 1 a 5, título e texto. As avaliações aparecem na página do produto e entram na nota média dele. Estas rotas, em /api/v1/vendor/reviews, mostram ao seller (lojista) as avaliações dos produtos dele, permitem uma resposta pública e, quando permitido, aprovar ou rejeitar.
Como funciona
status | Significado |
|---|---|
pending | Aguardando moderação; não aparece na loja. |
approved | Publicada e conta na nota média. |
rejected | Recusada pela moderação. |
spam, disabled, hidden | Outros estados que o administrador pode aplicar. |
Nesta API o status sai em palavras (approved). No filtro de listagem você pode usar palavras ou a letra (A, P, R, S, D, H).
- Ver o que chegou
Listar avaliações, por exemplo
reply=unreplied. - Responder
Responder publica o texto abaixo da avaliação.
Conceitos-chave
Quem é o dono
A avaliação pertence a um produto; o seller enxerga as avaliações dos produtos que são dele. Para aprovar, rejeitar ou responder a uma avaliação de outro seller, a resposta é 403 review is not on your product. A equipe do seller (gerente, membro) é reconhecida nestas rotas.
Dados do cliente
A lista mostra só o nome de exibição do avaliador (reviewer_name). A resposta de aprovar e rejeitar devolve a avaliação completa, incluindo user_id e, em avaliações de visitantes, guest_name e guest_email. Trate-os como dados pessoais.
Endpoints
| Método | Caminho | Para que serve | Autenticação |
|---|---|---|---|
| GET | /api/v1/vendor/reviews | Lista as avaliações dos produtos do seller. | vendor |
| PUT | /api/v1/vendor/reviews/{id}/approve | Aprova uma avaliação. | vendor |
| PUT | /api/v1/vendor/reviews/{id}/reject | Rejeita uma avaliação. | vendor |
| POST | /api/v1/vendor/reviews/{id}/reply | Publica ou substitui a resposta do seller. | vendor |
| DELETE | /api/v1/vendor/reviews/{id}/reply | Apaga a resposta do seller. | vendor |
Erros comuns
- Mandar a letra no corpo e palavra no filtro (ou o contrário). O filtro
statusaceita os dois; a resposta sempre sai em palavra. - Esperar
404ao apagar uma resposta que não existe. A rota responde500. - Responder com HTML. As tags são removidas; só o texto fica.
- Contar com aprovar/rejeitar pelo token do seller. Na versão atual essas duas rotas respondem
403 admin access required. - Responder com as respostas desligadas.
403 vendor replies are disabled by admin; consultevendor_replies_allowedna lista.