API atual/Referência completa/Avaliações e perguntas

POSTEnviar avaliação

Rota de avaliação direta no produto, desativada: a avaliação agora nasce de um item de pedido entregue.

Esta rota existia para enviar uma avaliação direto na página do produto. Ela foi desativada: sempre responde 410 Gone, qualquer que seja o corpo. Isso impede avaliações de quem nunca comprou. A avaliação passou a ser criada a partir do item de um pedido entregue, na área do cliente.

Mantenha seu app apontando para o caminho novo e use esta página só para reconhecer o erro caso um cliente antigo ainda chame a rota.

POST/api/v1/storefront/products/{id}/reviewsPública

Desativada: avaliação direta no produto

Parâmetros de caminho

idstringobrigatório

UUID ou slug do produto. Ignorado pela resposta.

Corpo da requisição

*object

Qualquer corpo é aceito e ignorado.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/storefront/products/5e833a7f-1a77-402c-835a-32594350d7a7/reviews" \
  -H "Content-Type: application/json" \
  -d '{}'

Resposta

410Rota desativada

json

{"detail":"review products from your delivered order","error":"reviews_only_from_order"}

O texto de detail é devolvido em inglês e error é o código estável: teste por error.

Erros

Status	Quando	Corpo de exemplo
410	Sempre.	`{"error":"reviews_only_from_order","detail":"review products from your delivered order"}`
403	O módulo de avaliações está desligado na loja.	`{"error":"module_disabled","module":"product-reviews"}`

Como avaliar hoje

Com o cliente logado, avalie cada produto de um pedido entregue em POST /api/v1/storefront/orders/{orderId}/items/{productId}/review, com rating (1 a 5), title e comment. Respostas: 201 {"pending": true} (a avaliação aguarda moderação), 401 login_required, 403 purchase_required, 404 order_not_found, 409 already_reviewed. Essa rota pertence à área de pedidos do cliente e é documentada lá.

Veja também