Bem-vindo à documentação da API de Voos. Integre busca de passagens aéreas, ofertas e calendário de preços em sua aplicação.

Documentação da API de Voos

Integre a pesquisa de passagens aéreas diretamente em sua aplicação. Acesse ofertas em tempo real, busque voos por múltiplos fornecedores e consulte calendários de preços.

Múltiplos Fornecedores

A API oferece acesso a múltiplos fornecedores de voos integrados via Moblix, com suporte a busca em tempo real e streaming de resultados.

O que a API oferece

┌─────────────────────────────────────────────────────────────┐
│                     Sua Aplicação                          │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                    API de Voos                              │
│  ┌───────────────────────────────────────────────────────┐ │
│  │  • Autenticação por API Key                           │ │
│  │  • Busca de voos em tempo real (REST + SSE)           │ │
│  │  • Autocomplete de aeroportos                         │ │
│  │  • Ofertas de voos destacadas                         │ │
│  │  • Calendário de preços                               │ │
│  │  • Controle de requisições e quotas                   │ │
│  └───────────────────────────────────────────────────────┘ │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│              Fornecedores Integrados (Moblix)               │
│  ┌───────────────────────────────────────────────────────┐ │
│  │  • Múltiplos fornecedores de voos                     │ │
│  │  • Preços em tempo real                               │ │
│  │  • Streaming de resultados (SSE)                      │ │
│  │  • Deduplicação automática                            │ │
│  └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

Por que usar esta API?

Benefício	Descrição
Busca em Tempo Real	Resultados via streaming (SSE) ou REST tradicional
Múltiplos Fornecedores	Busque em vários fornecedores simultaneamente
Autocomplete Inteligente	Busca de aeroportos e cidades com dados completos
Ofertas Destacadas	Acesso a ofertas especiais e promocionais
Calendário de Preços	Veja os melhores preços por data em um período

Primeiros Passos

Obtenha suas credenciais

Acesse o painel de configurações e gere suas chaves de API.

Cada chave está vinculada ao seu time e tem limites de requisições conforme seu plano.

Configure a autenticação

Todas as requisições devem incluir o header Authorization com sua chave de API.

Authorization: Bearer mbx_live_8f92k3d7a9b2c4e6f8g0h1i2j3...

Faça sua primeira requisição

Teste a conexão buscando voos:

curl -X POST https://api.seudominio.com/api/v1/flights/search \
  -H "Authorization: Bearer sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "round_trip",
    "slices": [
      {
        "origin": "GRU",
        "destination": "MIA", 
        "departureDate": "2026-03-15"
      },
      {
        "origin": "MIA",
        "destination": "GRU", 
        "departureDate": "2026-03-22"
      }
    ],
    "passengers": [
      { "type": "adult", "count": 2 }
    ],
    "cabinClass": "economy"
  }'

const response = await fetch('https://api.seudominio.com/api/v1/flights/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sua_chave_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    type: 'round_trip',
    slices: [
      { origin: 'GRU', destination: 'MIA', departureDate: '2026-03-15' },
      { origin: 'MIA', destination: 'GRU', departureDate: '2026-03-22' }
    ],
    passengers: [
      { type: 'adult', count: 2 }
    ],
    cabinClass: 'economy'
  })
});

const data = await response.json();
console.log(`Request ID: ${data.requestId}`);

import requests

response = requests.post(
    'https://api.seudominio.com/api/v1/flights/search',
    headers={
        'Authorization': 'Bearer sua_chave_aqui',
        'Content-Type': 'application/json'
    },
    json={
        'type': 'round_trip',
        'slices': [
            {'origin': 'GRU', 'destination': 'MIA', 'departureDate': '2026-03-15'},
            {'origin': 'MIA', 'destination': 'GRU', 'departureDate': '2026-03-22'}
        ],
        'passengers': [
            {'type': 'adult', 'count': 2}
        ],
        'cabinClass': 'economy'
    }
)

data = response.json()
print(f"Request ID: {data['requestId']}")

Base URL

Todas as requisições devem ser feitas para:

https://api.seudominio.com/api/v1

Fluxo Típico de Integração

1. Autocomplete          →  POST /api/flights/consulta-aereo/aeroportos
                              ↓
2. Buscar Voos           →  POST /api/v1/flights/search (REST)
                              OU
                              POST /api/v1/flights/stream (SSE - Streaming)
                              ↓
3. Exibir Resultados     →  Mostrar voos encontrados ao cliente
                              ↓
4. Ver Ofertas           →  POST /api/ofertas/buscar
                              ↓
5. Calendário            →  GET /api/calendario-precos?origem=GRU&destino=MIA

Recursos Disponíveis

🔐 Autenticação

Como autenticar suas requisições e gerenciar API keys

✈️ Busca de Voos

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

🔍 Autocomplete

Buscar aeroportos e cidades para formulários de busca

🎯 Ofertas

Acessar ofertas destacadas e promocionais

📅 Calendário de Preços

Visualizar os melhores preços por data

Conceitos Importantes

Ofertas vs Busca Regular

Busca de Voos: Pesquisa em tempo real em múltiplos fornecedores para rotas específicas
Ofertas: Voos pré-selecionados com preços especiais, ideais para exibir em home pages

Slices e Segmentos

Slice: Um trecho da viagem (ex: São Paulo → Miami)
Segment: Um voo específico dentro de um slice (pode haver conexões)

Streaming vs REST

Modo	Quando Usar
REST (`/search`)	Buscar e aguardar resultado completo
SSE (`/stream`)	Receber resultados progressivamente em tempo real

Tipos de Busca

Tipo	Descrição
`one_way`	Somente ida
`round_trip`	Ida e volta
`multi_city`	Múltiplos trechos

Rate Limits

Plano	Limite de Requisições
FREE	50 requisições/mês
PRO	5.000 requisições/mês
BUSINESS	50.000 requisições/mês
ENTERPRISE	Customizado

Exceder os limites resultará em resposta 429 Too Many Requests.

Suporte

Precisa de ajuda com sua integração? Nossa equipe está disponível para auxiliar:

Email: suporte@moblix.com.br
Documentação: Você está aqui! 📚

Introdução