Visão Geral

Base URL

https://api.seudominio.com/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"]
}

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

Authorization: Bearer mbx_live_sua_chave_aqui

Os limites variam por plano:

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.