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

POSTResumo por IA

Força a regeneração do resumo de avaliações de um produto.

A página de produto pode mostrar um resumo das avaliações aprovadas, escrito por IA, com os aspectos mais citados. Normalmente ele é atualizado por uma rotina noturna; esta rota força a atualização de um produto agora, ignorando o cache. A chamada espera a geração terminar (até 30 segundos).

POST/api/v1/admin/reviews/summaries/regenerateAdmin

Refaz o resumo por IA das avaliações de um produto

Exige manage_reviews ou manage_content e o recurso de avaliações da loja ligado (ele acompanha o módulo product-reviews).

Corpo da requisição

product_iduuidobrigatório

Produto cujo resumo será refeito.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/admin/reviews/summaries/regenerate" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "7bc1d5e9-a9a4-457b-866f-bbb3879d258d"
}'

Resposta

200Concluído

json

{
  "regenerated": true
}

Campos da resposta

regeneratedboolean

Sempre true quando a chamada termina sem erro. Não garante que um resumo novo foi gerado (veja o aviso).

Erros

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"]}`
403	O recurso de avaliações está desligado na loja.	`{"error":"feature_not_available","feature":"reviews","detail":"switched off for this store"}`
400	Falta `product_id`.	`{"error":"product_id required"}`
500	Falha ao gerar, ou `product_id` que não é UUID.	`{"error":"failed to regenerate","detail":"..."}`

Veja também