Autenticação

Tokens de API são usados para autenticar requisições programáticas à plataforma.

Como obter um token

Gere um token de API pelo Dashboard. Acesse: Dashboard

Header de Autenticação

Todas as requisições protegidas devem incluir:

Authorization: Bearer <seu-token-api>

Tenant

GET /me/tenant

Retorna informações do tenant autenticado.

curl -X GET https://api.integracoesinteligentes.com/me/tenant \
  -H "Authorization: Bearer <token>"

Permissões necessárias

Permissão	Descrição
TENANTS_VIEW	Visualizar informações do tenant

Resposta:

{
  "data": {
    "id": "018e1234-5678-7abc-8def-0123456789ac",
    "name": "Minha Empresa",
    "webhook_url": "https://sua-api.com/webhooks",
    "created_at": "2024-01-15T10:30:00.000000Z",
    "updated_at": "2024-01-15T10:30:00.000000Z"
  }
}

Campos da resposta:

Campo	Tipo	Descrição
id	UUID	ID único do tenant
name	string	Nome do tenant
webhook_url	string|null	URL do webhook configurada
created_at	string	Data de criação (ISO 8601)
updated_at	string	Data de atualização (ISO 8601)

Erros de Autenticação

401 Unauthorized

Token inválido, expirado ou não fornecido.

{
  "message": "Unauthenticated."
}

403 Forbidden

Token válido, mas sem permissão para o recurso.

{
  "message": "This action is unauthorized."
}

Próximos Passos

• Drivers - Listar drivers disponíveis
• Installations - Gerenciar instalações
• Processing - Consultar eventos