Skip to main content
A Identity Link API usa OAuth2 com o fluxo client_credentials. Você envia seu clientId e clientSecret codificados em Base64 no cabeçalho Authorization: Basic e recebe um Bearer token válido por 3600 segundos. Todas as chamadas subsequentes devem incluir o token no cabeçalho Authorization: Bearer.

Credenciais

Você pode consultar suas credenciais chamando GET /users/me com um token válido. A resposta inclui:
  • clientId
  • clientSecret
  • webhookSecret (usado para validar assinaturas de webhook)
Guarde essas informações em variáveis de ambiente e nunca as exponha no frontend.

Obter token

Resposta

Usar o token

Inclua o token em todas as chamadas autenticadas:

Renovação e cache

O token expira em 3600 segundos (1 hora). Armazene o token em cache e renove-o antes da expiração para evitar chamadas desnecessárias ao endpoint de token.
Se o token estiver expirado ou inválido, a API retorna 401 Unauthorized. Não tente reutilizar tokens de sessões anteriores sem verificar a validade.
A referência completa de códigos está em Erros.
Última modificação em 28 de agosto de 2026