Ratenlimits und Paginierung
Wie viele Anfragen Sie stellen können, welche Header Ihnen Ihren Stand zeigen und wie Sie durch große Sammlungen blättern.
Zur besseren Verständlichkeit übersetzt. Code, Feldnamen und die API-Referenz bleiben auf Englisch. Englische Fassung
Ratenlimits
Es gelten zwei Limits, beide in festen Ein-Minuten-Fenstern. Das Workspace-Limit umfasst alle API-Anfragen des Workspaces zusammen (REST-API mit API-Token und die Zendesk-kompatible API) und hängt von Ihrem Plan ab:
| Plan | Anfragen pro Minute, ganzer Workspace |
|---|---|
| Free | Kein API-Zugang |
| Starter | 200 |
| Growth | 400 |
| Pro | 700 |
| Enterprise | 2.500 |
Zusätzlich kann ein einzelner API-Token höchstens 700 Anfragen pro Minute stellen.
| Header | Bedeutung |
|---|---|
X-Rate-Limit, X-Rate-Limit-Remaining | Das Workspace-Limit und was davon in dieser Minute übrig ist |
X-RateLimit-Limit, X-RateLimit-Remaining | Dasselbe für den Token |
X-RateLimit-Reset | Sekunden, bis das Token-Fenster zurückgesetzt wird |
Über dem Limit erhalten Sie 429 Too Many Requests mit einem Retry-After-Header. Warten Sie so viele Sekunden und versuchen Sie es dann erneut. Erhöhen Sie die Wartezeit exponentiell, wenn weiter 429 kommt.
Paginierung
Sammlungen sind seitenbasiert: ?page=2&itemsPerPage=50, bis zu 100 Einträge pro Seite.
Für Exporte und Synchronisierungen unterstützt GET /api/tickets auch Cursor-Paginierung, die konsistent bleibt, während Tickets angelegt werden:
- Senden Sie für die erste Seite
?cursor=&limit=100(ein leerer Cursor). - Folgen Sie
links.next, bismeta.has_morefalse ist.
Ergebnisse sind nach ID sortiert, also in Erstellungsreihenfolge. Die Zendesk-kompatible API unterstützt die Zendesk-Varianten Offset, Cursor und inkrementeller Export.