Bem-vindo à documentação da API Reservei. Integre busca e reserva de passagens aéreas em sua aplicação.

Documentação da API Reservei

Integre a pesquisa e reserva de passagens aéreas da Reservei diretamente em sua aplicação. Acesse nosso inventário global com preços competitivos, markup automático e confirmação imediata.

Inventário Global

A API Reservei oferece acesso a mais de 300 companhias aéreas incluindo LATAM, GOL, Azul, American Airlines, United, Delta, Air France, British Airways, Emirates, e muitas outras.

O que a API oferece

┌─────────────────────────────────────────────────────────────┐
│                     Sua Aplicação                          │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                    API Reservei                             │
│  ┌───────────────────────────────────────────────────────┐ │
│  │  • Autenticação por API Key                           │ │
│  │  • 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                      │
│  ┌───────────────────────────────────────────────────────┐ │
│  │  • 300+ companhias aéreas                             │ │
│  │  • Preços em tempo real                               │ │
│  │  • Emissão imediata de bilhetes                       │ │
│  │  • Gestão de reservas (hold, cancel)                  │ │
│  └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

Por que usar a API Reservei?

Benefício	Descrição
Precificação Automática	Markup e taxas aplicados automaticamente nas ofertas
Conversão de Moeda	Preços convertidos para BRL com margem configurável
Multi-Agência	Cada API key herda configurações específicas do time
Inventário Amplo	Acesso a mais de 300 companhias aéreas globais
Emissão Simplificada	Crie reservas com hold ou emissão instantânea

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 herda automaticamente:

Percentual de markup configurado
Taxa fixa por reserva
Moeda padrão (BRL)

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 ofertas de voos:

curl -X POST https://app.reservei.co/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": "2025-03-15"
      },
      {
        "origin": "MIA",
        "destination": "GRU", 
        "departureDate": "2025-03-22"
      }
    ],
    "passengers": [
      { "type": "adult", "count": 2 },
      { "type": "child", "count": 1 }
    ],
    "cabinClass": "economy"
  }'

const response = await fetch('https://app.reservei.co/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: '2025-03-15' },
      { origin: 'MIA', destination: 'GRU', departureDate: '2025-03-22' }
    ],
    passengers: [
      { type: 'adult', count: 2 },
      { type: 'child', count: 1 }
    ],
    cabinClass: 'economy'
  })
});

const { offers } = await response.json();
console.log(`Encontradas ${offers.length} ofertas`);

import requests

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

data = response.json()
print(f"Encontradas {len(data['offers'])} ofertas")

Base URL

Todas as requisições devem ser feitas para:

https://app.reservei.co/api/v1

Fluxo Típico de Integração

1. Buscar Voos          →  POST /api/v1/flights/search
                              ↓
2. Selecionar Oferta    →  Exibir ofertas para o cliente
                              ↓
3. Criar Reserva        →  POST /api/v1/bookings (type: "hold" ou "instant")
                              ↓
4. Confirmar Pagamento  →  PUT /api/v1/bookings/:id/confirm
                              ↓
5. Emitir Bilhetes      →  Automático após confirmação

Recursos Disponíveis

🔐 Autenticação

Como autenticar suas requisições e gerenciar API keys

✈️ Voos

Buscar ofertas de voos em tempo real com preços calculados

📋 Reservas

Criar e gerenciar reservas (hold e emissão instantânea)

💰 Wallet

Gerenciar saldo e transações para pagamentos

🔔 Webhooks

Receber notificações em tempo real sobre eventos

Uma oferta representa uma combinação específica de voos que pode ser reservada por um preço específico. As ofertas têm validade limitada (geralmente 15-30 minutos) e devem ser reservadas antes de expirarem.

Slices e Segments

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

Tipos de Reserva

Tipo	Descrição	Uso
`hold`	Reserva temporária (24-72h para pagar)	Aguardar aprovação do cliente
`instant`	Emissão imediata do bilhete	Pagamento já confirmado

Precificação

Os preços retornados pela API já incluem:

Tarifa base da companhia aérea
Taxas de embarque e segurança
Markup configurado para sua agência
Taxa fixa por reserva (se configurada)

Rate Limits

Endpoint	Limite
`/flights/search`	60 req/min
`/bookings`	30 req/min
Outros	120 req/min

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@reservei.co
Documentação: Você está aqui! 📚

Introdução