Skip to main content
Todas as rotas /api/v1/* requerem autenticação via API Key.

Header de autenticação

Authorization: Bearer ik_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Como obter uma API Key

1

Acesse o painel

Entre em app.useintegra.com.br e vá em Settings > API Keys.
2

Crie uma nova key

Clique em Nova API Key e dê um nome descritivo (ex: “Integração CRM”).
3

Copie a key

A key só será exibida uma vez. Se perdê-la, revogue e crie uma nova.

Formato da key

As API Keys seguem o formato ik_live_ seguido de 64 caracteres hexadecimais:
ik_live_a1b2c3d4e5f6789...

Segurança

  • A key é hasheada com SHA-256 antes de ser armazenada
  • Cada key pertence a uma organização e filtra dados automaticamente
  • Keys podem ser revogadas a qualquer momento no painel
  • O último uso de cada key é rastreado automaticamente

Erros de autenticação

StatusMensagemCausa
401Missing Authorization headerHeader não enviado
401Invalid API key formatKey não começa com ik_live_
401Invalid or revoked API keyKey inválida ou revogada