Avaliações
Devolve as avaliações aprovadas de um produto, com a nota média, para a tela de detalhe do app.
Avaliações são os comentários e notas que clientes deixam num produto. O app mostra a nota média e a lista de comentários na ficha do produto. Esta rota é anônima e só devolve avaliações aprovadas pela moderação da loja.
/api/4.0/sra_discussionPúblicaAvaliações de um produto
A ordem é da mais nova para a mais antiga.
Parâmetros de consulta
object_idstringId do produto (decimal ou UUID). Sem ele, a lista vem vazia em vez de dar erro.
object_typestringpadrão: PPMP avaliações de produto. M seria avaliação de seller, que a plataforma não tem: sempre vem vazia. Qualquer outro valor também vem vazio.pageintegerpadrão: 1Página, a partir de 1.
items_per_pageintegerpadrão: 20Itens por página. (
per_page é um sinônimo.) Valor menor que 1 vira 20.Exemplo de requisição
bash
curl "$BASE_URL/api/4.0/sra_discussion?object_type=P&object_id=1585658495&items_per_page=10"Resposta
200Avaliações retornadas
json
{
"average_rating": 4.5,
"posts": [
{
"post_id": "6d1f5b1e-3a52-4ac2-9c31-1c6d5a4f0e11",
"name": "Maria S.",
"message": "Chegou rápido e é exatamente como na foto.",
"rating": 5,
"timestamp": 1791676800
}
],
"search": { "page": 1, "items_per_page": 10, "total_items": 1 }
}Campos da resposta
average_ratingnumberNota média das avaliações aprovadas do produto.
0 quando não há.posts[].post_idstringId da avaliação (UUID).
posts[].namestringNome de quem avaliou, como a loja o exibe.
posts[].messagestringTexto da avaliação. Vazio quando o cliente só deu a nota.
posts[].ratingintegerNota de 1 a 5.
posts[].timestampintegerData da avaliação em Unix timestamp (segundos, UTC).
searchobjectPaginação:
page, items_per_page e total_items. Atenção: aqui a chave é search, não params.Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Authorization presente mas não é uma ekey válida | {"error":"unauthorized"} |
| 500 | Falha ao listar | {"error":"failed to list discussion","detail":"..."} |