Autenticação e versionamento

Vale para todos os produtos do Economilha API.

Autenticação

Todas as requisições (exceto o health check) exigem uma API Key enviada via header.

Header	Obrigatório	Descrição
`x-api-key`	✅	Sua chave de API fornecida pelo Economilha


x-api-key: sua-api-key-aqui

Se a API Key estiver ausente, inválida ou vazia, a API retorna 401 Unauthorized.

Cada produto é habilitado individualmente na sua chave. Uma chave válida para Busca de Voos não dá acesso automático ao Histórico de Preços — nesse caso a resposta é 403 AUTHORIZATION_ERROR. Entre em contato com o suporte para contratar um produto.

Versionamento (Content Negotiation)

A API usa content negotiation via header Accept para controle de versão.

Header `Accept`	Versão utilizada
`application/vnd.economilha.v1+json`	v1 (recomendado)
`application/json`	v1 (padrão)

Se um media type não suportado for enviado, a API retorna 406 Not Acceptable.


Accept: application/vnd.economilha.v1+json

Sempre envie o header Accept explícito com application/vnd.economilha.v1+json. Omitir o header funciona hoje (assume v1), mas o padrão acompanha a versão mais recente — o que significa que sua integração pode mudar de comportamento sem você alterar nada quando publicarmos uma nova versão.

Headers padrão

Request

Header	Obrigatório	Descrição
`x-api-key`	✅	Chave de autenticação
`Accept`	Não	Media type para versionamento (padrão: `application/json`)
`Content-Type`	✅ (POST)	Deve ser `application/json`

Response

Header	Descrição
`Content-Type`	`application/json`