> ## 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.

# Visão geral da API

> Base URL, autenticação, escolha da sessão e erros.

**Base:** `https://<seu-zapmeow>/api`. Toda rota leva `X-Api-Key`.

## Como a sessão é escolhida

Nesta ordem:

1. no caminho: `/api/sessions/{nome}/...` ou `/api/{nome}/...`;
2. na query: `?session=nome`;
3. no corpo JSON de `POST`/`PUT`: `{"session":"nome"}`;
4. se só existe uma sessão, ela.

Sem nenhuma: `400 informe a sessão`. Sessão inexistente: `404`.

## Erros

Sempre JSON: `{"error":"mensagem"}`. Códigos: `400` entrada inválida, `401` chave, `404` sessão ou rota, `409` já pareada, `422` já existe, `502` WhatsApp recusou, `503` sessão sem conexão.

## Rotas

| Grupo | Página |
| - | - |
| Servidor e sessões | [Sessões](https://docs.zapmeow.com/api-reference/sessions.md) |
| Envio, reação, presença, mídia | [Mensagens](https://docs.zapmeow.com/api-reference/messages.md) |
| Contatos, conversas, etiquetas, grupos | [Contatos e conversas](https://docs.zapmeow.com/api-reference/contacts-chats.md) |

`GET /api/server/version` → `{"version","engine":"ZAPMEOW","tier":"CORE"}`. `GET /health` (sem chave) → `{"ok":true}`.


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