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

# Autenticação

> Autentique chamadas à API SkalePayments usando sua API Key.

Todas as rotas documentadas exigem uma API Key enviada no header `X-API-Key`.

```http theme={null}
X-API-Key: sk_sua_chave_aqui
```

## Exemplo

```bash theme={null}
curl --request GET \
  --url 'https://api.skalepayments.com.br/company' \
  --header 'X-API-Key: sk_sua_chave_aqui'
```

> [!WARNING]
>
> A API Key concede acesso à sua conta. Nunca a exponha no frontend, em aplicativos distribuídos, logs públicos ou repositórios.

## Boas práticas

* Faça chamadas à API somente pelo seu backend.
* Armazene a chave em variável de ambiente ou cofre de segredos.
* Utilize chaves diferentes entre aplicações quando essa opção estiver disponível.
* Troque imediatamente qualquer chave que possa ter sido exposta.
* Remova a chave dos logs de requisição e de erro.

## Falhas de autenticação

Uma chave ausente, inválida ou sem permissão pode produzir uma resposta `401` ou `403`. Confira se:

1. O nome do header é exatamente `X-API-Key`.
2. Não existem espaços adicionais no valor.
3. A chave pertence à conta correta e continua ativa.
4. A conta possui permissão para usar o recurso solicitado.

Consulte o [guia de erros](https://docs.skalepayments.com.br/ajuda/erros.md) para conhecer o envelope de erro da API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.