Conceitos
Paginação e limites
Paginação
Listas aceitam page (a partir de 1) e per_page (1 a 100, padrão 25) e respondem com data, meta (current_page, per_page, total, last_page) e links. Siga links.next até null. Exemplo: GET /services.
Limites de taxa
| Limite | Padrão | Chave |
|---|---|---|
| Emissão de token | 10 / min | IP de origem |
| Leitura (GET) | 120 / min | integração |
| Escrita (POST, PATCH, DELETE) | 60 / min | integração |
| Corpo da requisição | 512 KB | requisição |
As respostas trazem X-RateLimit-Limit e X-RateLimit-Remaining. Ao estourar: 429 RATE_LIMIT_EXCEEDED com Retry-After. Para aumentar (até 1.200/min), peça ao suporte informando o client_id e o volume esperado.
Referência gerada a partir do contrato OpenAPI 3.1 da API v1 (versão 2026-10-26), conferido contra o código por teste automatizado. Dúvidas: suporte@cuidaro.com.br.