Autenticação

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

Acesse o Dashboard
Navegue até Configurações > Chaves de API
Clique em Gerar Nova Chave
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"

const API_KEY = process.env.LEAVO_API_KEY;

const response = await fetch('https://api.leavo.ai/backend/leads', {
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  }
});

import os
import requests

API_KEY = os.environ.get('LEAVO_API_KEY')

response = requests.get(
    'https://api.leavo.ai/backend/leads',
    headers={
        'Authorization': f'Bearer {API_KEY}',
        'Content-Type': 'application/json'
    }
)

<?php
$apiKey = getenv('LEAVO_API_KEY');

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.leavo.ai/backend/leads');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

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

Erro	Causa	Solução
Missing header	Header `Authorization` não enviado	Adicione o header à requisição
Invalid token	Chave inválida ou mal formatada	Verifique se a chave está correta
Expired token	Chave expirou	Gere uma nova chave no dashboard
Revoked token	Chave foi revogada	Gere uma nova chave no dashboard

Início

Conceitos

Boas Práticas

Visão Geral

Obtendo sua Chave de API

Usando a Chave de API

Boas Práticas de Segurança

Use Variáveis de Ambiente

Defina Expiração

Use HTTPS

Delete Chaves Não Utilizadas

Erros de Autenticação

Causas Comuns

​Visão Geral

​Obtendo sua Chave de API

​Usando a Chave de API

​Boas Práticas de Segurança

Use Variáveis de Ambiente

Defina Expiração

Use HTTPS

Delete Chaves Não Utilizadas

​Erros de Autenticação

​Causas Comuns

Visão Geral

Obtendo sua Chave de API

Usando a Chave de API

Boas Práticas de Segurança

Erros de Autenticação

Causas Comuns