Referência da API

Avaliações

As notas (1 a 5 estrelas) e comentários que os clientes deram na DM de entrega.

Rotas deste grupo1

GET/reviewsListar avaliaçõesreviews:read

Listar avaliações

GET/api/v1/reviews

Da mais nova para a mais antiga.

Permissão: reviews:read

Parâmetros da URL

`rating`	inteiro	Só uma nota (1 a 5).
`from / to`	data ISO	Avaliadas a partir de (inclusive) e antes de.
`page`	inteiro	Página, a partir de 1. Padrão 1.
`per_page`	inteiro	Itens por página, de 1 a 100. Padrão 20.

Exemplo

curl

curl https://zolvibot.app/api/v1/reviews \
  -H "Authorization: Bearer zv_sk_SUA_CHAVE"

Resposta 200

{
  "data": [
    {
      "order_id": "cmw8d6urw0001ssugmol9xqu2",
      "order_number": 1042,
      "rating": 5,
      "comment": "Chegou na hora!",
      "rated_at": "2026-11-08T15:40:00.000Z",
      "customer": {
        "id": "cmvrlovla0001ssvcuio6xvf7",
        "discord_id": "1390611228354809977",
        "username": "cliente"
      },
      "products": [
        {
          "product_id": "cmvrllzcq000bssokqrrb39n8",
          "product_name": "Key Steam",
          "variant_name": "30D",
          "quantity": 2
        }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "last_page": 1
  }
}