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

Documentação da API de Busca 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.

API de Busca (Search)

Esta API é focada em consulta e busca de voos (pagantes e milhas). Para reservar e emitir passagens pagantes, veja a API Reservei (Shopping) - consolidadora NDC.

O que a API oferece

┌─────────────────────────────────────────────────────────────┐
│                     Sua Aplicação                          │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                API de Busca de Voos (Search)                │
│  ┌───────────────────────────────────────────────────────┐ │
│  │  • 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://app.apidevoos.dev/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://app.apidevoos.dev/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://app.apidevoos.dev/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://app.apidevoos.dev/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

Limites de Uso

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.

Exceder o limite mensal (plano FREE) ou ficar sem créditos (plano PAID) resultará em resposta 429 Too Many Requests. Adicione créditos no dashboard para continuar.

Precisa de Reserva e Emissão?

Esta API é focada em busca e consulta de voos. Se você precisa reservar e emitir passagens aéreas, a Moblix oferece a API Reservei (Shopping).

API Reservei - Shopping

A API Reservei é uma consolidadora NDC que permite reserva e emissão de passagens pagantes com inventário global.

Importante: A Reservei trabalha apenas com voos pagantes (dinheiro). Não é possível reservar ou emitir passagens com milhas através da Reservei.

┌─────────────────────────────────────────────────────────────┐
│                     Sua Aplicação                          │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                    API Reservei (Shopping)                  │
│             Consolidadora NDC - Voos Pagantes               │
│  ┌───────────────────────────────────────────────────────┐ │
│  │  • Autenticação por API Key                           │ │
│  │  • Tecnologia NDC (New Distribution Capability)       │ │
│  │  • Markup e taxas configuráveis por agência           │ │
│  │  • Conversão automática de moeda (USD/EUR → BRL)     │ │
│  │  • Histórico de reservas                              │ │
│  │  • Sistema de wallet para pagamentos                  │ │
│  │  • Webhooks para notificações                         │ │
│  └───────────────────────────────────────────────────────┘ │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│         Inventário Global de Voos via NDC                   │
│  ┌───────────────────────────────────────────────────────┐ │
│  │  • 300+ companhias aéreas                             │ │
│  │  • Preços em tempo real via NDC                       │ │
│  │  • Emissão imediata de bilhetes                       │ │
│  │  • Gestão de reservas (hold, cancel)                  │ │
│  │  • Conteúdo exclusivo e tarifas privadas              │ │
│  └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

Funcionalidades da API Reservei

Funcionalidade	Descrição
Consolidadora NDC	Tecnologia New Distribution Capability para acesso a conteúdo exclusivo
Inventário Global	300+ companhias aéreas com tarifas competitivas (apenas voos pagantes)
Reserva e Emissão	Reserve e emita bilhetes pagantes em tempo real
Markup Automático	Configure markup e taxas por agência
Wallet	Sistema de carteira pré-paga com recarga instantânea
Gestão de Reservas	Hold, confirmação e cancelamento de reservas
Webhooks	Notificações em tempo real de eventos
Multi-moeda	Conversão automática USD/EUR → BRL
Tarifas Exclusivas	Acesso a conteúdo e tarifas privadas via NDC

Quando usar cada API?

Necessidade	API Recomendada
Consultar preços de voos pagantes	API de Busca (esta)
Consultar disponibilidade em milhas	API de Busca (esta)
Mostrar ofertas em seu site	API de Busca (esta)
Criar comparador de preços	API de Busca (esta)
Reservar e emitir voos pagantes	API Reservei
Gestão completa de PNRs	API Reservei
Sistema de agência completo	API Reservei
Reservar/emitir com milhas	❌ Não disponível via API

Saiba mais sobre a API Reservei

Acesse reservei.co para conhecer a plataforma completa de reserva e emissão de passagens aéreas.

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