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

# Autenticação

> Entenda como autenticar-se na API do Scanify usando sua chave de API

<Info>
  **Pré-requisito**: Gere sua chave de API no painel da plataforma do Scanify. Ela será usada para autenticar todas as requisições.
</Info>

## Como autenticar

Todas as requisições à API do Scanify exigem autenticação via header `Authorization`, no formato **Bearer**.

```bash theme={"dark"}
-H "Authorization: Bearer SUA_CHAVE_DE_API"
```

<Warning>
  **Nota**: A chave de API é única e permanente para sua conta (a menos que você regenere).
</Warning>

## Exemplo com cURL

Inclua sua chave de API no header `Authorization` de cada requisição:

```bash theme={"dark"}
curl -X POST https://api.scanify.com.br/extract \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"file":{"fileUrl":"https://seudominio.com/boleto.pdf"},"callbackUrl":"https://seudominio.com/webhook"}'
```

## Boas práticas

* Nunca exponha sua chave de API em ambientes públicos ou código client-side.
* Prefira armazená-la em variáveis de ambiente.
* Se necessário, você pode regenerar a chave diretamente na plataforma.

## Resolução de Problemas

Confira abaixo algumas soluções para problemas comuns relacionados à autenticação na API do Scanify:

<AccordionGroup>
  <Accordion title="Erro 401 - Unauthorized"> Esse erro indica que a chave de API está ausente ou incorreta. Verifique se o header `Authorization` está no formato correto: `Bearer SUA_CHAVE_DE_API`. </Accordion>
  <Accordion title="Outros erros"> Consulte a página [Erros e códigos](/errors) para a lista completa de respostas de erro. </Accordion>
</AccordionGroup>