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

# Autenticação

> Como gerar e usar sua apikey

A API externa é autenticada por uma **apikey própria da sua empresa** —
diferente do login (e-mail/senha) usado no portal. Ela nunca expira sozinha;
fica ativa até ser revogada.

## Gerando sua chave

1. Entre no portal com um usuário **administrador da sua empresa**.
2. Abra o menu do usuário (canto superior direito) → **Apikey**.
3. Clique em **Criar apikey**.
4. Copie a chave exibida — ela só aparece **uma única vez**, nesse momento.
   Se perdê-la, gere uma nova (a anterior é revogada automaticamente).

<Warning>
  Só existe **uma chave ativa por empresa** por vez. Gerar uma nova sempre
  revoga a anterior — qualquer integração usando a chave antiga para de
  funcionar imediatamente.
</Warning>

## Usando a chave

Envie a chave no header `X-API-Key` em toda requisição:

```bash theme={null}
curl https://api.qa.nlbs.ai/api/entities?document=12345678900 \
  -H "X-API-Key: nlbs_sua_chave_aqui"
```

Uma chave ausente, inválida ou revogada retorna `401 Unauthorized`.

## Testando pela documentação

Cada página em [Referência da API](/api-reference) tem um botão
**Authorize** (ou um campo de apikey no painel de teste) — cole sua chave lá
para testar os endpoints direto pelo navegador, sem precisar montar a
chamada manualmente.

## Revogando

Na mesma tela **Apikey** do portal, o botão **Revogar** desativa a chave
ativa imediatamente — use se a chave vazar ou uma integração for
descontinuada.