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

# Limites e erros

> Limite de chamadas por minuto e os erros comuns a todas as rotas.

## Limite de chamadas

Cada chave pode fazer **60 chamadas por minuto** (plano pro). Toda resposta traz o saldo nos cabeçalhos:

| Cabeçalho | Significado |
| - | - |
| `X-RateLimit-Limit` | Limite por minuto |
| `X-RateLimit-Remaining` | Chamadas que ainda restam na janela |
| `X-RateLimit-Reset` | Quando a janela recomeça |

Acima do limite, a resposta é `429`. Espere o `X-RateLimit-Reset` antes de tentar de novo.

## Erros comuns a todas as rotas

| Código | Quando acontece |
| - | - |
| `400` | Corpo ou parâmetro inválido. O corpo da resposta diz qual campo. |
| `401` | Chave ausente, inválida, revogada ou vencida. |
| `403` | Escopo insuficiente ou clínica com acesso suspenso. |
| `429` | Limite de chamadas atingido. |
| `500` | Erro interno. Tente de novo mais tarde; se repetir, abra chamado informando o horário. |

Algumas rotas têm códigos próprios, como o `409` de paciente já cadastrado. Eles aparecem na página de cada rota, na aba **Referência da API**.


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