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>"

Resposta:

{
  "data": {
    "id": "018e1234-5678-7abc-8def-0123456789ac",
    "name": "Minha Empresa",
    "status": "active",
    "webhook_url": "https://sua-api.com/webhooks",
    "plan_details": null,
    "created_at": "2024-01-15T10:30:00.000000Z",
    "updated_at": "2024-01-15T10:30:00.000000Z",
    "tenant_member": {
      "role": "owner",
      "accepted_at": "2024-01-15T10:30:00.000000Z",
      "created_at": "2024-01-15T10:30:00.000000Z",
      "is_owner": true,
      "is_pending": false
    }
  }
}

Campos da resposta:

Campo	Tipo	Descrição
id	UUID	ID único do tenant
name	string	Nome do tenant
status	string	Status do tenant (active, suspended, deleted)
webhook_url	string|null	URL do webhook configurada
plan_details	object|null	Detalhes do plano
created_at	string	Data de criação (ISO 8601)
updated_at	string	Data de atualização (ISO 8601)
tenant_member	object|null	Dados do usuário no tenant (presente quando autenticado via token)
tenant_member.role	string	Função (admin, member)
tenant_member.accepted_at	string|null	Data de aceite do convite
tenant_member.created_at	string	Data de criação do vínculo
tenant_member.is_owner	boolean	Se é o proprietário do tenant
tenant_member.is_pending	boolean	Se o convite ainda está pendente

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