Autenticação

Toda chamada à API é autenticada por uma API key enviada no cabeçalho Authorization, no formato Bearer token.

Como obter sua API key

Ainda não existe autoatendimento pra isso na Área do Cliente -- hoje quem gera a chave é a equipe CentralFiscal, não o próprio cliente.

1. Peça sua API key pelo canal de atendimento CentralFiscal do seu contrato, informando se é pro ambiente Homologação (gratuito e ilimitado para testes) ou Produção.
2. A chave chega em texto puro uma única vez -- guarde-a com segurança assim que receber.
3. Quando estiver pronto pra produção, peça uma chave separada pra esse ambiente -- nunca reuse a de homologação.

Exemplo de requisição autenticada

curl https://areacliente.centralfiscal.com.br/v1/nfse/emissoes/{emissao_id} \
  -H "Authorization: Bearer cf_live_51JqK..."

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "cf_live_51JqK...");

var response = await client.GetAsync(
    "https://areacliente.centralfiscal.com.br/v1/nfse/emissoes/" + emissaoId);

const response = await fetch(
  `https://areacliente.centralfiscal.com.br/v1/nfse/emissoes/${emissaoId}`,
  { headers: { Authorization: "Bearer cf_live_51JqK..." } }
);

import requests

response = requests.get(
    f"https://areacliente.centralfiscal.com.br/v1/nfse/emissoes/{emissao_id}",
    headers={"Authorization": "Bearer cf_live_51JqK..."},
)

Erros de autenticação