Autenticação

Todas as requisições à API FonteData são autenticadas via API Key, enviada no header X-API-Key.

Obtendo sua API Key

1. Acesse o painel FonteData e crie sua conta.
2. No dashboard, navegue até a seção de API Keys.
3. Clique em Gerar nova chave e copie o valor gerado.

Usando a API Key

Inclua o header X-API-Key em todas as requisições:

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/cadastro-pf-basica?cpf=12345678900"

Exemplos por linguagem

Python

import requests

headers = {"X-API-Key": "SUA_CHAVE"}

response = requests.get(
    "https://app.fontedata.com/api/v1/consulta/cadastro-pf-basica",
    params={"cpf": "12345678900"},
    headers=headers,
)

print(response.json())

JavaScript (Node.js)

const response = await fetch(
  "https://app.fontedata.com/api/v1/consulta/cadastro-pf-basica?cpf=12345678900",
  {
    headers: { "X-API-Key": "SUA_CHAVE" },
  }
);

const data = await response.json();
console.log(data);

Erros de autenticação

Código	Mensagem	Causa
401	Não Autenticado	API Key ausente, inválida ou expirada.
403	Não Autorizado	API Key válida, mas saldo insuficiente para a consulta.

Boas práticas

• Variáveis de ambiente — armazene sua chave em variáveis de ambiente (FONTEDATA_API_KEY) em vez de hardcoded no código.
• Rotação de chaves — gere uma nova chave periodicamente e revogue as anteriores no dashboard.
• Uma chave por aplicação — use chaves separadas para cada serviço ou ambiente, facilitando auditoria e revogação.