> ## Documentation Index
> Fetch the complete documentation index at: https://docs.validatech.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticação

> Como autenticar requisições na ValidaNFe API

# 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

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

### Exemplo com JavaScript

```javascript theme={null}
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](https://admin.validanfe.com)
2. Faça login em sua conta
3. Navegue até a seção "API Keys"
4. Gere uma nova chave ou copie uma existente

<Warning>
  **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
</Warning>

## 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                  |

<Info>
  **Precisa de ajuda?**

  Se você está tendo problemas com a autenticação, entre em contato com nosso suporte: [suporte@validanfe.com](mailto:suporte@validanfe.com)
</Info>