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

# Autenticação

> Uma chave de API protege /api e /ws.

Toda chamada a `/api/*` e `/ws` leva a chave definida em `ZAPMEOW_API_KEY`:

| Forma | Onde |
| - | - |
| `X-Api-Key: <chave>` | igual ao WAHA; use esta |
| `Authorization: Bearer <chave>` | alternativa |
| `?key=<chave>` | só em `GET`; para o WebSocket do navegador e `<img>` do QR |

Sem chave ou chave errada: `401 {"error":"chave inválida"}`.

`/health` e o HTML do `/dashboard/` são públicos. O dashboard não mostra nada sem a chave: ele pede a chave e guarda em `sessionStorage`.

> [!NOTE]
>
> A chave precisa de 16 caracteres ou mais. O serviço não sobe sem ela.


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