Referência da API

Referência completa de todos os endpoints da API Moblix. A API é RESTful, utiliza JSON para requests/responses e autenticação via Bearer Token.

Base URL

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

Autenticação

Todas as requisições requerem autenticação via header Authorization:

Authorization: Bearer mbx_live_sua_chave_aqui
Content-Type: application/json

Consulte a documentação de autenticação para obter suas chaves de API.

Endpoints de Busca

✈️ Voos

Busca de passagens aéreas em tempo real.

POST /api/v1/flights/search

🏨 Hotéis

Busca de hospedagem com disponibilidade.

POST /api/v1/hotels/search

🎯 Experiências

Catálogo de passeios, tours e atividades.

GET /api/v1/experiences

Endpoints de Gestão

📋 Reservas

Criar e gerenciar reservas de viagens.

GET, POST /api/v1/bookings

👥 Clientes

Gerenciar clientes pessoa física e jurídica.

GET, POST, PATCH, DELETE /api/v1/clients

💰 Orçamentos

Criar propostas e orçamentos comerciais.

GET, POST, PATCH, DELETE /api/v1/quotes

Formato das Respostas

Sucesso

{
  "data": {
    "id": "uuid",
    "name": "exemplo"
  },
  "timestamp": "2026-01-26T10:30:00Z"
}

Sucesso com Lista

{
  "data": {
    "items": [...],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 150,
      "totalPages": 3
    }
  },
  "timestamp": "2026-01-26T10:30:00Z"
}

Erro

{
  "error": "Mensagem do erro",
  "code": "ERROR_CODE",
  "timestamp": "2026-01-26T10:30:00Z"
}

Códigos HTTP

Código	Descrição
`200`	OK - Requisição bem-sucedida
`201`	Created - Recurso criado
`400`	Bad Request - Parâmetros inválidos
`401`	Unauthorized - Falha na autenticação
`403`	Forbidden - Sem permissão (plano necessário)
`404`	Not Found - Recurso não encontrado
`429`	Too Many Requests - Rate limit excedido
`500`	Internal Server Error - Erro interno

Rate Limits

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

Exceder os limites resultará em resposta 429 Too Many Requests. Aguarde alguns segundos antes de tentar novamente.

Endpoint de Status

Verifique se a API está funcionando:

GET /api/v1/health

{
  "status": "ok",
  "version": "v1",
  "timestamp": "2026-01-26T10:30:00Z",
  "endpoints": {
    "flights_search": "POST /api/v1/flights/search",
    "hotels_search": "POST /api/v1/hotels/search",
    "experiences": "/api/v1/experiences",
    "bookings": "/api/v1/bookings",
    "clients": "/api/v1/clients",
    "quotes": "/api/v1/quotes",
    "me": "/api/v1/me"
  }
}