Rate Limits
A API do Synax aplica limites de requisições para garantir estabilidade.
Limites por endpoint
| Endpoint | Limite | Janela |
|---|
REST API (/rest/v1/) | 1000 req | por minuto |
Edge Functions (/functions/v1/) | 300 req | por minuto |
Auth (/auth/v1/) | 30 req | por minuto |
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 997
X-RateLimit-Reset: 1709136000
Quando exceder o limite
Ao exceder, a API retorna status 429 Too Many Requests:
{
"message": "Rate limit exceeded",
"retryAfter": 30
}
Use o header Retry-After para saber quando tentar novamente.
Boas práticas
- Use paginação (
limit e offset) para listar muitos registros
- Cache respostas quando possível
- Implemente retry com backoff exponencial
- Agrupe operações em batch quando a API suportar