Visão Geral

Base URL

https://app.apidevoos.dev/api/v1

Buscar voos em tempo real com REST ou Streaming (SSE).

POST /v1/flights/search
POST /v1/flights/stream

Buscar aeroportos e cidades para formulários de busca.

POST /flights/consulta-aereo/aeroportos
POST /flights/consulta-aereo/pesquisar-aeroporto

Acessar ofertas destacadas e promocionais.

POST /ofertas/buscar

Visualizar os melhores preços por data.

GET /calendario-precos

A maioria dos endpoints retorna:

{
  "success": true,
  "data": {
    // Dados da resposta
  },
  "message": "Operação realizada com sucesso"
}

{
  "success": false,
  "error": "Código do erro",
  "message": "Descrição do erro",
  "errors": ["Detalhes adicionais"]
}

Código	Descrição
`200`	Sucesso
`201`	Criado com sucesso
`400`	Requisição inválida
`401`	Não autenticado
`403`	Sem permissão
`404`	Não encontrado
`429`	Quota mensal ou créditos excedidos
`500`	Erro interno

Todas as requisições requerem autenticação via header Authorization:

Authorization: Bearer mbx_live_sua_chave_aqui

O sistema funciona com dois modelos:

Plano	Requisições/Mês	Custo por Requisição
FREE	50 (limite fixo)	Gratuito
PAID	Ilimitado*	R$ 0,25 por requisição

* Limitado apenas pelo saldo de créditos pré-pagos disponível.

Nota: Não há rate limits (requisições por minuto). O único limite é a quota mensal (plano FREE) ou o saldo de créditos (plano PAID).

Endpoints que retornam listas suportam paginação:

{
  "data": [...],
  "page": 0,
  "pageSize": 20,
  "totalItens": 150
}

Use códigos IATA de 3 letras para aeroportos:

{
  "origin": "GRU",
  "destination": "MIA"
}

Códigos de cidade também são aceitos (ex: SAO para São Paulo).

A API está na versão v1. Mudanças breaking terão nova versão (v2, v3...).

URLs de versões antigas continuam funcionando após novos lançamentos.