Limites de débit et pagination
Combien de requêtes vous pouvez faire, les en-têtes qui indiquent où vous en êtes et comment parcourir de grandes collections.
Traduit pour votre confort. Le code, les noms de champs et la référence de l'API restent en anglais. Version anglaise
Limites de débit
Deux limites s'appliquent, toutes deux par fenêtres fixes d'une minute. La limite de l'espace de travail couvre toutes les requêtes API de l'espace ensemble (API REST avec un token d'API et API compatible Zendesk) et dépend de votre offre :
| Offre | Requêtes par minute, tout l'espace de travail |
|---|---|
| Free | Pas d'accès à l'API |
| Starter | 200 |
| Growth | 400 |
| Pro | 700 |
| Enterprise | 2 500 |
En plus, un seul token d'API peut faire au maximum 700 requêtes par minute.
| En-tête | Signification |
|---|---|
X-Rate-Limit, X-Rate-Limit-Remaining | La limite de l'espace de travail et ce qu'il en reste dans cette minute |
X-RateLimit-Limit, X-RateLimit-Remaining | La même chose pour le token |
X-RateLimit-Reset | Secondes avant la réinitialisation de la fenêtre du token |
Au-delà de la limite, vous recevez 429 Too Many Requests avec un en-tête Retry-After. Attendez ce nombre de secondes, puis réessayez. Augmentez l'attente de façon exponentielle si vous recevez encore 429.
Pagination
Les collections sont paginées : ?page=2&itemsPerPage=50, jusqu'à 100 éléments par page.
Pour les exports et les synchronisations, GET /api/tickets accepte aussi la pagination par curseur, qui reste cohérente pendant la création de tickets :
- Envoyez
?cursor=&limit=100(un curseur vide) pour la première page. - Suivez
links.nextjusqu'à ce quemeta.has_moresoit false.
Les résultats sont triés par id, c'est-à-dire par ordre de création. L'API compatible Zendesk accepte les styles Zendesk : offset, curseur et export incrémental.