Bem-vindo à documentação da API Moblix. Integre busca e reserva de voos, hotéis e experiências em sua aplicação.

Documentação da API Moblix

Integre o sistema completo de busca e reservas de viagens da Moblix diretamente em sua aplicação. Busque voos em tempo real, hotéis, experiências e gerencie reservas com nossa API RESTful.

Plano Business Necessário

O acesso à API Moblix está disponível exclusivamente para clientes do plano Business. Faça upgrade para começar a integrar.

O que a API oferece

┌─────────────────────────────────────────────────────────────┐
│                     Sua Aplicação                           │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                    API Moblix v1                            │
│  ┌───────────────────────────────────────────────────────┐  │
│  │  ✈️  Busca de Voos em Tempo Real                      │  │
│  │  🏨  Busca de Hotéis com Disponibilidade              │  │
│  │  🎯  Catálogo de Experiências e Passeios              │  │
│  │  📋  Gestão Completa de Reservas                      │  │
│  │  👥  Cadastro e Gestão de Clientes                    │  │
│  │  💰  Orçamentos e Propostas Comerciais                │  │
│  └───────────────────────────────────────────────────────┘  │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                 Fornecedores Integrados                     │
│  ┌───────────────────────────────────────────────────────┐  │
│  │  • Rextur (voos nacionais e internacionais)          │  │
│  │  • BestBuy (hotéis e hospedagem)                     │  │
│  │  • Fornecedores de experiências                      │  │
│  └───────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

Por que usar a API Moblix?

Benefício	Descrição
Busca em Tempo Real	Voos e hotéis com preços e disponibilidade atualizados
Multi-fornecedor	Integração com Rextur, BestBuy e outros consolidadores
White-label	Use sua própria marca, sem menção à Moblix
Gestão Completa	Clientes, reservas e orçamentos em um só lugar
Segurança	Dados isolados por equipe com RLS policies

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 suas configurações.

⚠️ Importante: Todas as chaves são de produção e acessam dados reais. Use com cuidado!

Configure a autenticação

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

Authorization: Bearer mbx_live_sua_chave_aqui

Faça sua primeira requisição

Teste a conexão buscando voos:

curl -X POST https://app.moblix.co/api/v1/flights/search \
  -H "Authorization: Bearer mbx_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "GRU",
    "destination": "GIG",
    "departureDate": "2026-03-15",
    "adults": 2
  }'

const response = await fetch('https://app.moblix.co/api/v1/flights/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mbx_live_sua_chave_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    origin: 'GRU',
    destination: 'GIG',
    departureDate: '2026-03-15',
    adults: 2
  })
});

const data = await response.json();
console.log(`Encontrados ${data.flightGroups.length} voos`);

import requests

response = requests.post(
    'https://app.moblix.co/api/v1/flights/search',
    headers={
        'Authorization': 'Bearer mbx_live_sua_chave_aqui',
        'Content-Type': 'application/json'
    },
    json={
        'origin': 'GRU',
        'destination': 'GIG',
        'departureDate': '2026-03-15',
        'adults': 2
    }
)

data = response.json()
print(f"Encontrados {len(data['flightGroups'])} voos")

Base URL

Todas as requisições devem ser feitas para:

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

Fluxo Típico de Integração

1. Cadastrar Cliente     →  POST /api/v1/clients
                              ↓
2. Buscar Voos/Hotéis    →  POST /api/v1/flights/search
                              POST /api/v1/hotels/search
                              ↓
3. Criar Orçamento       →  POST /api/v1/quotes
                              ↓
4. Criar Reserva         →  POST /api/v1/bookings
                              ↓
5. Acompanhar Status     →  GET /api/v1/bookings/:id

Recursos Disponíveis

🔐 Autenticação

Como autenticar suas requisições e gerenciar API keys

✈️ Voos

Busca de passagens aéreas em tempo real

🏨 Hotéis

Busca de hospedagem com disponibilidade

🎯 Experiências

Passeios, tours e atividades

📋 Reservas

Gestão completa de reservas

👥 Clientes

Cadastro de clientes PF e PJ

💰 Orçamentos

Propostas comerciais personalizadas

Conceitos Importantes

Clientes (Customers)

Um cliente pode ser pessoa física (individual) ou jurídica (company). Campos obrigatórios variam conforme o tipo:

Pessoa Física: nome, email, CPF (opcional)
Pessoa Jurídica: razão social, email, CNPJ (opcional)

Voos (Flights)

A busca de voos retorna:

Grupos de voos (ida + volta quando aplicável)
Preços por passageiro e total
Informações de bagagem
Detalhes de cada segmento (escalas)

Hotéis (Hotels)

A busca de hotéis retorna:

Lista de propriedades disponíveis
Tipos de quarto com preços
Fotos e amenidades
Políticas de cancelamento

Reservas (Bookings)

Uma reserva representa uma compra confirmada:

Pode conter voos, hotéis ou experiências
Status: pending, confirmed, cancelled
Informações de pagamento
Dados dos passageiros

Orçamentos (Quotes)

Um orçamento é uma proposta comercial:

Itens customizados com preços
Data de validade
Pode ser convertido em reserva
Status: draft, sent, accepted, declined

Paginação

Todos os endpoints de listagem suportam paginação:

GET /api/v1/clients?page=1&limit=50

Parâmetro	Padrão	Máximo	Descrição
`page`	1	-	Número da página
`limit`	50	100	Itens por página

Resposta:

{
  "data": {
    "customers": [...],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 150,
      "totalPages": 3
    }
  }
}

Rate Limits

Endpoint	Limite
`/flights/search`	30 req/min
`/hotels/search`	30 req/min
`/clients/*`	100 req/min
`/bookings/*`	100 req/min
`/experiences/*`	100 req/min
Health check	Ilimitado

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

Segurança

✅ Boas Práticas

Use variáveis de ambiente para armazenar API keys
Nunca exponha chaves em código front-end ou repositórios públicos
Rotacione chaves periodicamente
Monitore o uso via painel de desenvolvedor
Use HTTPS em todas as requisições

🔒 Proteções Implementadas

Hash SHA-256 das API keys
RLS policies no banco (isolamento por equipe)
Logs de auditoria completos
Rate limiting automático

Suporte

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

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

Introdução