Rate limits

​

Limites par defaut

​

Headers de rate limit

​

Depassement de la limite

{
  "error": {
    "type": "rate_limit_error",
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded the rate limit of 20 requests per second.",
    "retryable": true,
    "request_id": "req_a1b2c3d4e5f6",
    "retry_after_seconds": 1
  }
}

​

Bonnes pratiques

1. Respectez Retry-After — attendez le temps indique avant de reessayer
2. Utilisez le backoff exponentiel — si les tentatives echouent toujours, augmentez le temps d’attente
3. Mettez en cache les reponses — stockez les resultats localement pour eviter les requetes redondantes
4. Utilisez last_activity_since — pour les workflows de synchronisation, ne recuperez que les conversations avec une nouvelle activite au lieu de tout re-telecharger
5. Utilisez total_count — pour repondre aux questions “combien ?” sans parcourir toutes les pages de resultats