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

# Referência da API

> Todas as rotas da API pública v1, geradas do OpenAPI que a própria API serve. Teste direto na página com a chave de um app.

Esta referência sai do mesmo arquivo que a API serve em [`https://api.westhetics.io/v1/openapi.json`](https://api.westhetics.io/v1/openapi.json): o que está aqui é o que a API faz. Cada página traz os parâmetros, o corpo, as respostas e os erros da rota, com exemplos em curl, JavaScript e Python.

## Testar na página

O painel de teste de cada rota chama a API de verdade, na clínica da chave. Cole a chave de um app em **Authorization** (`wx_…`) e envie.

> [!WARNING]
>
> O teste age na clínica real: criar uma paciente cria a ficha, enviar uma anamnese manda a
> mensagem. Para experimentar, use uma clínica de teste ou um app só com escopos de leitura.

## Em toda chamada

| Assunto | Na API |
| - | - |
| Endereço | `https://api.westhetics.io/v1` |
| Autenticação | `Authorization: Bearer wx_…` (a chave do app) ou o token OAuth da pessoa. Veja [autenticação](https://docs.westhetics.io/autenticacao.md) |
| Formato | JSON UTF-8, campos em camelCase, ids uuid, datas ISO 8601 em UTC, dinheiro em centavos (`…Cents`) |
| Item | `{ "data": { … } }` |
| Lista | `{ "data": [ … ], "meta": { "limit", "nextCursor" } }`. Veja [paginação](https://docs.westhetics.io/paginacao.md) |
| Erro | `{ "error": { "code", "message", "fields"?, "requestId" } }`. Veja [erros](https://docs.westhetics.io/erros.md) |
| Limite | 100 por minuto, com `X-RateLimit-*`. Veja [limites](https://docs.westhetics.io/limites.md) |
| Repetição segura | `Idempotency-Key` nos `POST`. Veja [idempotência](https://docs.westhetics.io/idempotencia.md) |

## Os grupos

> [card] Conta
>
> `GET /v1/me`: quem chama, em que clínica, com quais escopos.

> [card] Pacientes
>
> Buscar, sincronizar, criar e editar fichas.

> [card] Anamneses
>
> Enviar, reenviar, cancelar, ler o status e, com escopo próprio, as respostas.

> [card] Catálogo
>
> Procedimentos, prestadores e modelos de documento da clínica.

> [card] Atendimentos e documentos
>
> Gerar o contrato e os termos, enviar para assinatura e baixar o PDF.

> [card] Eventos e webhooks
>
> O que aconteceu na clínica e para onde avisar.


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