Límites de uso y paginación
Cuántas peticiones puedes hacer, las cabeceras que te dicen dónde estás y cómo recorrer colecciones grandes.
Traducido para tu comodidad. El código, los nombres de campos y la referencia de la API siguen en inglés. Versión en inglés
Límites de uso
Se aplican dos límites, ambos en ventanas fijas de un minuto. El límite del espacio de trabajo cubre todas las peticiones a la API del espacio juntas (API REST con un token de API y la API compatible con Zendesk) y depende de tu plan:
| Plan | Peticiones por minuto, todo el espacio de trabajo |
|---|---|
| Free | Sin acceso a la API |
| Starter | 200 |
| Growth | 400 |
| Pro | 700 |
| Enterprise | 2500 |
Además, un solo token de API puede hacer como máximo 700 peticiones por minuto.
| Cabecera | Significado |
|---|---|
X-Rate-Limit, X-Rate-Limit-Remaining | El límite del espacio de trabajo y lo que queda en este minuto |
X-RateLimit-Limit, X-RateLimit-Remaining | Lo mismo para el token |
X-RateLimit-Reset | Segundos hasta que se reinicia la ventana del token |
Por encima del límite recibes 429 Too Many Requests con una cabecera Retry-After. Espera esos segundos y vuelve a intentarlo. Aumenta la espera de forma exponencial si sigues recibiendo 429.
Paginación
Las colecciones van por páginas: ?page=2&itemsPerPage=50, hasta 100 elementos por página.
Para exportaciones y sincronizaciones, GET /api/tickets también admite paginación por cursor, que se mantiene coherente mientras se crean tickets:
- Envía
?cursor=&limit=100(un cursor vacío) para la primera página. - Sigue
links.nexthasta quemeta.has_moresea false.
Los resultados se ordenan por id, que es el orden de creación. La API compatible con Zendesk admite los estilos de Zendesk: offset, cursor y exportación incremental.