Skip to main content

​
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:
  1. Acesse o painel administrativo
  2. Faça login em sua conta
  3. Navegue até a seção “API Keys”
  4. 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ódigoDescrição
200Requisição autenticada com sucesso
401API Key inválida ou ausente
403API Key válida mas sem permissão para o recurso
429Limite de requisições excedido
Precisa de ajuda?Se você está tendo problemas com a autenticação, entre em contato com nosso suporte: [email protected]