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

# Autenticação

> Toda requisição é autenticada com o token de segurança da sua conta.

Toda conta possui um **`securityToken`** pessoal. Encontre-o no painel em
**Minhas configurações → Acesso a API** (`/opcoes`). Trate-o como uma senha —
ele dá acesso total aos pedidos e créditos da sua conta.

Existem **dois estilos de autenticação**, conforme o produto.

## Token de API (Cartas, E-mail, Recibos)

As rotas principais de cartas e e-mail recebem o token **na URL** (rotas de
leitura) ou como o campo de formulário **`userSecurityToken`** (rotas de
criação). O header `securityToken` e o `Authorization: Bearer` funcionam nos
endpoints de logo e recibos.

<CodeGroup>
  ```bash URL (rotas de leitura de cartas/e-mail) theme={null}
  curl "https://app.escrybe.com.br/api/v2/balance/SEU_TOKEN"
  ```

  ```bash Header (logo, recibos) theme={null}
  curl "https://app.escrybe.com.br/api/v2/logo" \
    -H "securityToken: SEU_TOKEN"
  ```

  ```bash Bearer (logo, recibos) theme={null}
  curl "https://app.escrybe.com.br/api/receipts/v1/get?order_id=2607031" \
    -H "Authorization: Bearer SEU_TOKEN"
  ```
</CodeGroup>

<Info>
  Para endpoints `POST` (ex.: criar um pedido ou e-mail) envie
  `userSecurityToken` como campo de formulário no corpo da requisição. Ele
  também é aceito como parâmetro de query onde os formatos de header
  funcionam.
</Info>

## HTTP Basic (WhatsApp)

Os endpoints de WhatsApp usam **HTTP Basic Auth**, onde o usuário é o **e-mail**
da conta e a senha é o **`securityToken`**.

<CodeGroup>
  ```bash cURL (codificado automaticamente) theme={null}
  curl "https://app.escrybe.com.br/api/whatsapp/v1/senders/get" \
    -u "voce@exemplo.com:SEU_TOKEN"
  ```

  ```bash Header manual theme={null}
  # Authorization: Basic base64("voce@exemplo.com:SEU_TOKEN")
  curl "https://app.escrybe.com.br/api/whatsapp/v1/senders/get" \
    -H "Authorization: Basic dm9jZUBleGVtcGxvLmNvbTpTRVVfVE9LRU4="
  ```
</CodeGroup>

## Erros

| Status | Significado                                   |
| ------ | --------------------------------------------- |
| `401`  | Credenciais ausentes ou inválidas             |
| `403`  | Autenticado, mas sem permissão para o recurso |

Veja [Erros](/pt/erros) para o formato completo dos envelopes.