Distribuição de eficiência

Distribuição por faixas de eficiência.

Resumo técnico

Método: Método HTTP GET
Rota: /aggregations/efficiency-distribution
URL completa: https://uzjxyrtbszreqxjvpzpv.supabase.co/functions/v1/public-catalog-phase1/aggregations/efficiency-distribution

Quando usar

Use em histogramas/gráficos de distribuição.

Headers obrigatórios

Header	Obrigatório	Descrição	Exemplo
X-API-Key	Sim	Chave pública fornecida para consumo da API pública.	SUA_PUBLIC_KEY
X-API-Secret	Sim	Segredo pareado à API Key para autenticação.	SEU_SECRET

Campos principais da resposta

Retorna `data.data.items[]` com `faixa` e `total`.

Nome	Tipo	Obrigatório	Descrição	Exemplo
data.data.items[].faixa	string	Não	Campo retornado pelo endpoint.	-
data.data.items[].total	string	Não	Campo retornado pelo endpoint.	-

Cenários de uso

Alimentar dashboards com `data.data.items` por grupo (brand/year/fuel/category).
Usar endpoints de distribuição para histogramas (`faixa`, `total`).

Exemplos de integração

Os exemplos desta documentação utilizam dados fictícios/mockados para fins ilustrativos, mas seguem a estrutura oficial real da API.

Nunca exponha X-API-Secret em aplicações front-end públicas. Para aplicações web públicas, faça a chamada a partir do seu backend.

Exemplo de integração (cURL)

curl -X GET "https://uzjxyrtbszreqxjvpzpv.supabase.co/functions/v1/public-catalog-phase1/aggregations/efficiency-distribution" \
  -H "X-API-Key: SUA_PUBLIC_KEY" \
  -H "X-API-Secret: SEU_SECRET"

Os exemplos desta documentação utilizam dados fictícios/mockados para fins ilustrativos, mas seguem a estrutura oficial real da API.

Exemplo de resposta

{
  "success": true,
  "data": {
    "data": {
      "items": [
        {
          "faixa": "<= 8 km/l eq",
          "total": 210
        },
        {
          "faixa": "8-12 km/l eq",
          "total": 442
        },
        {
          "faixa": "12-16 km/l eq",
          "total": 280
        },
        {
          "faixa": "> 16 km/l eq",
          "total": 68
        }
      ]
    },
    "meta": {
      "generated_at": "2026-04-17T22:03:16.372Z",
      "request_id": "762f6abe-1846-4c04-a979-e348c3e0c072"
    }
  }
}

Erros possíveis (exemplo de payload)

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Parâmetros inválidos: page deve ser maior que 0"
  }
}

Header

Obrigatório

Descrição

Exemplo

X-API-Key

Sim

Chave pública fornecida para consumo da API pública.

SUA_PUBLIC_KEY

X-API-Secret

Sim

Segredo pareado à API Key para autenticação.

SEU_SECRET

Nome

Tipo

Obrigatório

Descrição

Exemplo

data.data.items[].faixa

string

Não

Campo retornado pelo endpoint.

data.data.items[].total

string

Não

Campo retornado pelo endpoint.

{ "success": true, "data": { "data": { "items": [ { "faixa": "<= 8 km/l eq", "total": 210 }, { "faixa": "8-12 km/l eq", "total": 442 }, { "faixa": "12-16 km/l eq", "total": 280 }, { "faixa": "> 16 km/l eq", "total": 68 } ] }, "meta": { "generated_at": "2026-04-17T22:03:16.372Z", "request_id": "762f6abe-1846-4c04-a979-e348c3e0c072" } } }

Carregando...