Quota e limites

Como a quota é consumida

Cada busca consome 1 unidade de quota por companhia solicitada.
A quota é consumida independentemente do sucesso ou falha da busca na companhia.
O consumo é idêntico nos formatos RAW e PARSED.
Exemplo: uma busca com "airlineLoyalty": ["SMILES", "LATAM", "AZUL"] consome 3 unidades.
Se a quota for insuficiente, a API retorna 402 Payment Required.

Consultar quota

Retorna a quota de uso da API Key autenticada.


GET /quota

Headers obrigatórios

Header	Valor
`x-api-key`	`sua-api-key`

Response `200 OK`


{
  "limit": 1000,
  "consumed": 45,
  "remaining": 955,
  "usageByCompany": [
    {
      "airlineLoyalty": "SMILES",
      "consumed": 20
    },
    {
      "airlineLoyalty": "LATAM",
      "consumed": 15
    },
    {
      "airlineLoyalty": "AZUL",
      "consumed": 10
    }
  ]
}

Campos da resposta

Campo	Tipo	Descrição
`limit`	`int`	Limite total da quota
`consumed`	`int`	Total de chamadas consumidas
`remaining`	`int`	Chamadas restantes
`usageByCompany`	`array`	Detalhamento por programa de fidelidade

Objeto `usageByCompany[]`

Campo	Tipo	Descrição
`airlineLoyalty`	`string`	Programa de fidelidade
`consumed`	`int`	Chamadas consumidas para este programa

Response `404 Not Found`

Retornado quando a API Key não é encontrada no sistema.


{
  "error": {
    "code": "HTTP_ERROR",
    "message": "API key not found. Please ensure your API key is valid.",
    "correlationId": "uuid-aqui"
  }
}

Monitore sua quota periodicamente com GET /quota — essa chamada não consome quota. Para aumentar seu limite, entre em contato com economilha@economilha.com.