Autenticação

A API Moblix utiliza autenticação via Bearer Token. Todas as requisições devem incluir o header Authorization com sua chave de API.

Formato da API Key

As chaves de API seguem o padrão:

Obtendo suas Chaves

Formato do Header

Inclua o header Authorization em todas as requisições:

Authorization: Bearer mbx_live_sua_chave_aqui
Content-Type: application/json

Exemplos de Autenticação

curl -X GET https://app.moblix.co/api/v1/me \
  -H "Authorization: Bearer mbx_live_sua_chave_aqui" \
  -H "Content-Type: application/json"

const apiKey = process.env.MOBLIX_API_KEY;

const response = await fetch('https://app.moblix.co/api/v1/me', {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data.team.name);

import os
import requests

api_key = os.environ.get('MOBLIX_API_KEY')

headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://app.moblix.co/api/v1/me',
    headers=headers
)

data = response.json()
print(data['team']['name'])

Gerenciamento de Chaves

Listando Chaves

No painel de API Keys você pode ver:

• Nome: Identificação que você definiu
• Prefixo da chave: Primeiros caracteres para identificação
• Data de criação: Quando a chave foi gerada
• Último uso: Última vez que a chave foi utilizada

Revogando Chaves

Para revogar uma chave:

1. Acesse Configurações → Desenvolvedor
2. Localize a chave pelo nome ou prefixo
3. Clique no ícone de lixeira
4. Confirme a ação

Erros de Autenticação

Boas Práticas de Segurança

✅ Faça

• Armazene chaves em variáveis de ambiente
• Use secrets managers em produção (AWS Secrets, Vault, etc.)
• Rotacione chaves periodicamente
• Monitore o uso das chaves no painel
• Crie chaves separadas para cada aplicação

❌ Não Faça

• Commitar chaves em repositórios Git
• Expor chaves em código front-end
• Compartilhar chaves entre equipes diferentes
• Usar a mesma chave para múltiplas aplicações
• Ignorar alertas de uso suspeito

Testando a Autenticação

Verifique se sua chave está funcionando:

curl -X GET https://app.moblix.co/api/v1/me \
  -H "Authorization: Bearer mbx_live_sua_chave_aqui"

Resposta de sucesso:

{
  "data": {
    "team": {
      "id": "uuid",
      "name": "Minha Agência de Viagens"
    }
  }
}

Health Check

Para verificar se a API está disponível sem autenticação:

curl https://app.moblix.co/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"
  }
}