Autenticação

A ValidaNFe API utiliza autenticação baseada em API Key para garantir a segurança e controle de acesso às funcionalidades da plataforma.

Como funciona

Todas as requisições para a API devem incluir sua chave de API no header X-API-KEY. Esta chave identifica sua conta e permite que você acesse os recursos da API de forma segura.

Incluindo a API Key nas requisições

curl -H "X-API-KEY: SEU_TOKEN_AQUI" \
     -H "Accept: application/json" \
     "https://api.validanfe.com/NFe/ConsultarNFe/{chave}"

Exemplo com JavaScript

const response = await fetch('https://api.validanfe.com/NFe/ConsultarNFe/12345678901234567890123456789012345678901234', {
  headers: {
    'X-API-KEY': 'SEU_TOKEN_AQUI',
    'Accept': 'application/json'
  }
});

const data = await response.json();

Obtendo sua API Key

Para obter sua chave de API:

Acesse o painel administrativo
Faça login em sua conta
Navegue até a seção “API Keys”
Gere uma nova chave ou copie uma existente

Mantenha sua API Key segura

Nunca compartilhe sua chave de API publicamente
Não inclua a chave em repositórios de código público
Use variáveis de ambiente em suas aplicações
Regenere a chave se suspeitar de comprometimento

Códigos de resposta de autenticação

Código	Descrição
`200`	Requisição autenticada com sucesso
`401`	API Key inválida ou ausente
`403`	API Key válida mas sem permissão para o recurso
`429`	Limite de requisições excedido

Precisa de ajuda?Se você está tendo problemas com a autenticação, entre em contato com nosso suporte: suporte@validanfe.com