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

# Autenticação

> Como enviar requisições para a nossa API

# <Icon icon="lock" type="solid" /> Autenticação

<Tip>
  **Chave de API**: é sua credencial de acesso à AobaPay.\
  Ela identifica sua conta e autoriza as requisições.\
  **Sem a chave, as chamadas serão recusadas.**
</Tip>

***

## <Icon icon="key" type="solid" /> Gerenciamento de chaves

No dashboard da AobaPay você pode:

* Listar chaves ativas
* Criar novas chaves
* Revogar chaves comprometidas ou em desuso

<Card title="Erro de Autenticação" icon="warning" horizontal>
  A API retornará `401 Unauthorized` quando:

  * A chave não for enviada no header
  * A chave for inválida
  * A chave tiver sido revogada
</Card>

***

## <Icon icon="shield-check" type="solid" /> Boas práticas

<Card title="Segurança" icon="light-emergency-on" horizontal>
  * Armazene chaves em variáveis de ambiente ou gerenciadores de segredos
  * Nunca compartilhe suas chaves
  * A equipe da AobaPay **nunca solicitará** suas credenciais
  * Revogue imediatamente qualquer chave exposta
</Card>

***

## <Icon icon="plus-circle" type="solid" /> Criando uma chave

<Steps>
  <Step title="Acesse Integrações no Dashboard">
    <img src="https://mintcdn.com/cpay/5hGHuA5jSkOskfgD/images/criar-chave-api.png?fit=max&auto=format&n=5hGHuA5jSkOskfgD&q=85&s=9f085385adc807c2a16023ac63d588e3" className="rounded-lg" alt="Tela da AobaPay mostrando botão de criação de chave" width="1920" height="710" data-path="images/criar-chave-api.png" />

    <Card title="Clique em 'Criar Chave'">
      Inicie o processo de geração de uma nova chave de API.
    </Card>
  </Step>

  <Step title="Adicione uma descrição">
    <img src="https://mintcdn.com/cpay/5hGHuA5jSkOskfgD/images/exemplo-de-chave-api.png?fit=max&auto=format&n=5hGHuA5jSkOskfgD&q=85&s=c733b20d8b535cf810f304c859f7d665" className="rounded-lg" alt="Formulário com campo de descrição da chave" width="1869" height="549" data-path="images/exemplo-de-chave-api.png" />

    <Card title="Identifique a chave">
      Informe uma descrição clara para facilitar sua gestão.
    </Card>
  </Step>

  <Step title="Copie sua chave">
    <img src="https://mintcdn.com/cpay/5hGHuA5jSkOskfgD/images/copiar-chave-api.png?fit=max&auto=format&n=5hGHuA5jSkOskfgD&q=85&s=1a93c164d7b0d17ebe3de70e7e233696" className="rounded-lg" alt="Lista de chaves com opção de copiar" width="1920" height="712" data-path="images/copiar-chave-api.png" />

    <Card title="Armazene com segurança">
      Copie a chave gerada e salve em um local seguro.
    </Card>
  </Step>
</Steps>

***

## <Icon icon="terminal" type="solid" /> Usando sua chave

Inclua a chave em todas as requisições no header `Authorization`:

```bash theme={null}
curl -X POST https://api.aobapay.com/v1/charge/pix/create  \
  -H "Authorization: Bearer sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1000}'
```

<Card title="Importante" icon="info" horizontal>
  O mesmo endpoint (`https://api.aobapay.com`) é usado para **produção** e **desenvolvimento**.\
  O ambiente é definido automaticamente pela chave de API utilizada.
</Card>