A API Mivicall aplica rate limits por API key e por IP para garantir estabilidade.Documentation Index
Fetch the complete documentation index at: https://docs.mivicall.com/llms.txt
Use this file to discover all available pages before exploring further.
Limites default
| Dimensão | Limite | Janela |
|---|---|---|
| Por API key | 300 requests | 1 min (sliding) |
| Por API key | 30 requests | 1 segundo (burst) |
| Por IP | 100 requests | 1 min (defensivo) |
| Webhooks | sem rate limit | (apenas você → vocês) |
Headers de resposta
Cada resposta inclui:HTTP 429 Too Many Requests
Ao exceder, devolvemos:Backoff recomendado
Exponential backoff com jitter, idêntico ao do AWS SDK:Aumentar limites
Para integrações de alto volume (>5 clínicas-cliente, >10k requests/dia), contactem support@mivicall.com com:- API key prefix
- Volume estimado
- Caso de uso
Caching recomendado
Para reduzir hits ao rate limit:| Recurso | TTL sugerido | Notas |
|---|---|---|
GET /v1/tenants/me | 5 min | Config muda raramente |
GET /v1/professionals | 1 hora | Equipa estável |
GET /v1/services | 1 hora | Idem |
GET /v1/appointments?from=X&to=Y | 30s | Lista da agenda |
GET /v1/appointments/:id | sem cache | Pode ter mudado de status |
If-None-Match com ETag para 304 Not Modified (implementação em roadmap).