Início Rápido

Integre a API de Voos em sua aplicação em poucos minutos. Este guia mostra como fazer sua primeira busca de voos e usar os recursos principais.

Tempo estimado: 5 minutos

Obtenha sua API Key

Acesse o dashboard
Navegue até Configurações → API Keys
Clique em Criar Nova Chave
Copie sua chave (formato: mbx_live_...)

Guarde sua API Key em segurança. Ela não será exibida novamente!

Faça sua primeira busca de voos

Busque voos entre São Paulo e Miami:

curl -X POST https://api.seudominio.com/api/v1/flights/search \
  -H "Authorization: Bearer mbx_live_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": 1
      }
    ],
    "cabinClass": "economy"
  }'

Resposta: Você receberá um objeto com requestId e arrays flightGroups ou flightOffers contendo os voos encontrados.

Use Streaming para resultados em tempo real

Para receber resultados progressivamente conforme são encontrados:

const eventSource = new EventSource(
  'https://api.seudominio.com/api/v1/flights/stream',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer mbx_live_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: 1 }],
      cabinClass: 'economy'
    })
  }
);

// Busca iniciada
eventSource.addEventListener('search-initialized', (event) => {
  const data = JSON.parse(event.data);
  console.log('Request ID:', data.requestId);
});

// Novos voos encontrados
eventSource.addEventListener('flight-update', (event) => {
  const data = JSON.parse(event.data);
  console.log('Novos voos:', data.newGroups.length);
});

// Busca completa
eventSource.addEventListener('search-complete', (event) => {
  const data = JSON.parse(event.data);
  console.log('Total de voos:', data.totalGroups);
  eventSource.close();
});

Busque aeroportos (Autocomplete)

Para criar campos de busca com autocomplete:

curl -X POST https://api.seudominio.com/api/v1/flights/consulta-aereo/aeroportos?filtro=sao%20paulo \
  -H "Authorization: Bearer mbx_live_sua_chave_aqui"

Resposta:

{
  "Success": true,
  "Data": [
    {
      "Iata": "GRU",
      "Aeroporto": "Aeroporto Internacional de São Paulo/Guarulhos",
      "Cidade": "São Paulo",
      "Estado": "SP",
      "Pais": "Brasil"
    },
    {
      "Iata": "CGH",
      "Aeroporto": "Aeroporto de Congonhas",
      "Cidade": "São Paulo",
      "Estado": "SP",
      "Pais": "Brasil"
    }
  ]
}

Consulte ofertas destacadas

Veja ofertas especiais para exibir em sua home page:

curl -X POST https://api.seudominio.com/api/ofertas/buscar \
  -H "Authorization: Bearer mbx_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "internacional": true,
    "quantidade": 10,
    "shuffle": true
  }'

Resposta:

{
  "success": true,
  "data": [
    {
      "id": "123",
      "origem": {
        "iata": "GRU",
        "cidade": "São Paulo",
        "pais": "Brasil"
      },
      "destino": {
        "iata": "MIA",
        "cidade": "Miami",
        "pais": "Estados Unidos"
      },
      "precoMinimo": 1299.00,
      "moeda": "BRL",
      "companhiaAerea": "LATAM"
    }
  ],
  "totalItens": 50
}

Veja calendário de preços

Consulte os melhores preços por data:

curl "https://api.seudominio.com/api/calendario-precos?origem=GRU&destino=MIA" \
  -H "Authorization: Bearer mbx_live_sua_chave_aqui"

Resposta:

{
  "success": true,
  "data": {
    "origem": "GRU",
    "destino": "MIA",
    "precos": [
      {
        "data": "2026-03-15",
        "precoMinimo": 1299.00,
        "disponivel": true
      },
      {
        "data": "2026-03-16",
        "precoMinimo": 1450.00,
        "disponivel": true
      }
    ]
  }
}

Próximos Passos

Agora que você fez sua primeira integração, explore mais recursos:

Autenticação - Entenda tipos de chaves e segurança
Busca de Voos - Documentação completa da busca
Autocomplete - Integre busca de aeroportos
Ofertas - Exiba ofertas destacadas
Calendário - Mostre preços por data

Precisa de Ajuda?

📧 Email: suporte@moblix.com.br
💬 Chat: Disponível no dashboard
📚 Documentação: Você está aqui!

Exemplos de Integração

Em breve teremos exemplos completos de integração:

Framework	Status
Next.js	📋 Planejado
React	📋 Planejado
Vue.js	📋 Planejado
Python/Flask	📋 Planejado
PHP/Laravel	📋 Planejado

Início Rápido

On this page