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

# Autenticar com a API do SpherePay

> Todas as requisições à API do SpherePay usam autenticação por Bearer token. Saiba como gerar sua chave de API e passá-la corretamente em cada requisição.

Toda requisição à API do SpherePay deve ser autenticada usando uma chave de API. O SpherePay usa autenticação por Bearer token — você passa sua chave no cabeçalho `Authorization` de cada requisição. Esta página explica como gerar uma chave, como usá-la e como lidar com erros de autenticação.

## Obtenha sua chave de API

As chaves de API são geradas no painel do SpherePay:

1. Acesse [spherepay.co/dashboard](https://spherepay.co/dashboard).
2. Navegue até **Developers → API Keys**.
3. Selecione **Create New API Key**.
4. Copie a chave imediatamente — ela não será exibida novamente depois que você sair da página.

<Warning>
  Trate sua chave de API como uma senha. Nunca a exponha em código do lado do cliente, faça commit em controle de versão ou compartilhe em texto simples. Se uma chave for comprometida, revogue-a imediatamente no painel e gere uma nova.
</Warning>

## Faça uma requisição autenticada

Passe sua chave de API como um Bearer token no cabeçalho `Authorization` em cada requisição:

```bash theme={"dark"}
curl https://api.spherepay.co/v2/customer \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Todas as requisições devem usar **HTTPS**. Requisições feitas por HTTP simples serão rejeitadas.

## Cabeçalhos da requisição

| Cabeçalho       | Obrigatório         | Valor                 |
| --------------- | ------------------- | --------------------- |
| `Authorization` | Sim                 | `Bearer YOUR_API_KEY` |
| `Content-Type`  | Sim para POST/PATCH | `application/json`    |

## Erros de autenticação

Se sua chave de API estiver ausente, malformada ou inválida, a API retorna uma resposta `403 Forbidden`:

```json theme={"dark"}
{
    "status": 403,
    "detail": "Forbidden resource",
    "correlationId": "e633f28100526862cadc4c592435eddd"
}
```

Se você receber esse erro em uma chave que acredita ser válida, verifique o seguinte:

* O cabeçalho `Authorization` está formatado como `Bearer YOUR_API_KEY` com um único espaço entre `Bearer` e a chave — sem caracteres extras ou aspas.
* A chave não foi revogada. Acesse o painel em **Developers → API Keys** para verificar o status.
* Você está enviando a requisição por HTTPS, não HTTP.