Limites de débit
Les limites protègent l’API pour tous. Les intégrations habituelles restent largement en dessous de ces seuils.
Limites
| Périmètre | Limite |
|---|---|
| Requêtes par clé secrète | 600 par minute, avec des pics jusqu’à 50 par seconde |
| Requêtes d’écriture (POST, PATCH, DELETE) | 120 par minute et par clé |
| Synchronisation d’une source de connaissances | Une fois toutes les 10 minutes par source |
| Mode test | 100 par minute et par clé |
En-têtes
Chaque réponse indique votre consommation actuelle :
En-têtes de réponse
RateLimit-Limit: 600
RateLimit-Remaining: 587
RateLimit-Reset: 41RateLimit-Reset indique le nombre de secondes avant la réinitialisation de la fenêtre. En cas de dépassement, vous recevez un statut 429 avec un en-tête Retry-After exprimé en secondes.
Rester sous la limite
- Utilisez les webhooks pour recevoir les nouvelles conversations et les nouveaux tickets sans interroger régulièrement l’API.
- Demandez des pages de 100 objets avec
limit=100lorsque vous avez besoin de tout récupérer. - Mettez les contacts et les sources de connaissances en cache : ils changent rarement.
- Espacez les nouvelles tentatives, comme expliqué dans Gérer les erreurs.