Pular para o conteúdo principal

Visão Geral

A API do Leavo utiliza Bearer Token para autenticação. Todas as requisições devem incluir sua chave de API no header Authorization.
Mantenha sua chave de API segura e nunca a compartilhe publicamente. Não inclua chaves em código-fonte versionado.

Obtendo sua Chave de API

  1. Acesse o Dashboard
  2. Navegue até Configurações > Chaves de API
  3. Clique em Gerar Nova Chave
  4. Copie e armazene a chave com segurança
As chaves são exibidas apenas uma vez no momento da criação. Armazene-as em um local seguro.

Usando a Chave de API

Inclua o header Authorization em todas as suas requisições:
curl -X GET "https://api.leavo.ai/backend/leads" \
  -H "Authorization: Bearer sua_chave_aqui" \
  -H "Content-Type: application/json"

Boas Práticas de Segurança

Use Variáveis de Ambiente

Nunca hardcode suas chaves. Use variáveis de ambiente como LEAVO_API_KEY.

Defina Expiração

Configure datas de expiração para suas chaves e rotacione-as periodicamente.

Use HTTPS

Sempre use HTTPS para todas as requisições à API.

Delete Chaves Não Utilizadas

Remova chaves que não estão mais em uso para minimizar riscos.

Erros de Autenticação

Se sua autenticação falhar, você receberá uma resposta com status 401:
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}

Causas Comuns

ErroCausaSolução
Missing headerHeader Authorization não enviadoAdicione o header à requisição
Invalid tokenChave inválida ou mal formatadaVerifique se a chave está correta
Expired tokenChave expirouGere uma nova chave no dashboard
Revoked tokenChave foi revogadaGere uma nova chave no dashboard