Zendesk API-Ratenbegrenzungen: Ein vollständiger Entwicklerleitfaden für 2026
Stevia Putri
Zuletzt bearbeitet February 27, 2026
Wenn Sie Integrationen mit Zendesk erstellen, ist es nicht schön, um 2 Uhr morgens einen 429 Too Many Requests-Fehler zu erhalten. Das Verständnis der Zendesk API-Ratenbegrenzungen, bevor Sie mit dem Programmieren beginnen, bewahrt Sie vor hektischen Debugging-Sitzungen und verärgerten Stakeholdern, die sich fragen, warum ihre Ticket-Synchronisierung nicht mehr funktioniert.
Dieser Leitfaden schlüsselt alles auf, was Sie über Zendesk API-Ratenbegrenzungen wissen müssen. Wir werden die gestaffelten Begrenzungen nach Plan, die Überwachung Ihrer Nutzung in Echtzeit und praktische Strategien für den Umgang mit Ratenbegrenzungsfehlern auf elegante Weise behandeln. Egal, ob Sie Ticketdaten synchronisieren, ein benutzerdefiniertes Dashboard erstellen oder Workflows automatisieren, Sie werden lernen, wie Sie Integrationen erstellen, die innerhalb der Begrenzungen bleiben und gleichzeitig eine zuverlässige Leistung liefern.
Für Teams, die sich lieber überhaupt nicht mit Ratenbegrenzungen auseinandersetzen möchten, gibt es einen anderen Weg. eesel AI verbindet sich direkt mit Zendesk und übernimmt die Ratenbegrenzung automatisch. Wir werden beide Ansätze untersuchen, damit Sie auswählen können, was zu Ihrem Team passt.
Die gestaffelten Ratenbegrenzungen von Zendesk verstehen
Zendesk wendet je nach Plantyp und den spezifischen API-Endpunkten, die Sie verwenden, unterschiedliche Ratenbegrenzungen an. Lassen Sie uns aufschlüsseln, was Sie wissen müssen.
Ratenbegrenzungen nach Planstufe
Die API-Ratenbegrenzungen für Support und Help Center variieren erheblich je nach Ihrem Zendesk-Plan:
| Plan | Anfragen pro Minute |
|---|---|
| Team | 200 |
| Growth | 400 |
| Professional | 400 |
| Enterprise | 700 |
| Enterprise Plus | 2500 |
| High Volume API add-on | 2500 |
Quelle: Zendesk Rate Limits Documentation
Das High Volume API-Add-on erhöht Ihre Begrenzung auf 2500 Anfragen pro Minute. Es ist für Zendesk Suite Growth-Pläne und höher sowie für Zendesk Support Professional-Pläne und höher verfügbar. Sie benötigen mindestens 10 Agentenplätze, um dieses Add-on zu erwerben. Enterprise Plus-Pläne enthalten dieses Add-on standardmäßig.
Endpunktspezifische Begrenzungen
Einige Endpunkte haben ihre eigenen Ratenbegrenzungen, die die kontoweiten Begrenzungen überschreiben:
| Endpunkt | Ratenbegrenzung |
|---|---|
| Inkrementelle Exporte | 10 Anfragen pro Minute |
| Ticketliste (Seiten >500) | 50 Anfragen pro Minute |
| Ticket aktualisieren | 30 Aktualisierungen pro 10 Minuten pro Benutzer und Ticket |
| Chat API | 200 Anfragen pro Minute (alle Pläne) |
Quelle: Zendesk Rate Limits Documentation
Der Inkrementelle Export-Endpunkt ist besonders wichtig, wenn Sie große Datensätze synchronisieren. Sie können nur 10 Anfragen pro Minute an diese Endpunkte stellen, obwohl dies auf 30 Anfragen pro Minute steigt, wenn Sie das High Volume API-Add-on haben.
Überlegungen zur Help Center API
Die Help Center API verwendet die gleichen Ratenbegrenzungen wie die Support API. Anfragen an die Help Center API werden jedoch nicht auf Ihre Support API-Ratenbegrenzung angerechnet und umgekehrt. Dies bedeutet, dass Sie mit einem Enterprise-Plan gleichzeitig 700 Anfragen an die Support API und weitere 700 Anfragen an die Help Center API stellen können.
Überwachen von Zendesk API-Ratenbegrenzungsanfragen pro Minute in Ihrem Code
Zendesk stellt Antwort-Header bereit, mit denen Sie Ihren Ratenbegrenzungsstatus in Echtzeit überwachen können. Dies ist wichtig für die Erstellung von Integrationen, die ihre Anfragerate dynamisch anpassen können.
Antwort-Header verstehen
Jede API-Antwort von Zendesk enthält Header, die Ihnen Ihren aktuellen Ratenbegrenzungsstatus mitteilen:
- X-Rate-Limit oder ratelimit-limit: Die aktuelle Ratenbegrenzung Ihres Kontos (z. B. 700)
- X-Rate-Limit-Remaining oder ratelimit-remaining: Anzahl der verbleibenden Anfragen in der aktuellen Minute
- ratelimit-reset: Unix-Zeitstempel, wann das aktuelle Ratenbegrenzungsfenster zurückgesetzt wird
- zendesk-ratelimit-tickets-index: Zusätzliche Begrenzungsinformationen für Ticketlisten-Endpunkte
Für Ticketing API-Listenendpunkte wie Ticketliste oder Benutzersuche erhalten Sie zusätzliche Header:
x-rate-limit: 700
ratelimit-limit: 700
x-rate-limit-remaining: 699
ratelimit-remaining: 699
ratelimit-reset: 41
zendesk-ratelimit-tickets-index: total=100; remaining=99; resets=41
Quelle: Zendesk Best Practices for Avoiding Rate Limiting
Header in Python lesen
So extrahieren und verwenden Sie Ratenbegrenzungs-Header in Python:
import requests
import time
def call_zendesk_api():
url = "https://subdomain.zendesk.com/api/v2/tickets"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
response = requests.get(url, headers=headers)
should_continue = handle_rate_limits(response)
if should_continue:
# Process the API response
pass
def handle_rate_limits(response):
account_limit = response.headers.get("ratelimit-remaining")
endpoint_limit = response.headers.get("Zendesk-RateLimit-Endpoint")
account_limit_reset = response.headers.get("ratelimit-reset")
if account_limit:
account_remaining = int(account_limit)
if account_remaining > 0:
if endpoint_limit:
endpoint_remaining = int(endpoint_limit.split(";")[1].split("=")[1])
if endpoint_remaining > 0:
return True
else:
endpoint_reset = int(endpoint_limit.split(";")[2].split("=")[1])
handle_limit_exceeded(endpoint_reset)
else:
return True
else:
handle_limit_exceeded(account_limit_reset)
return False
def handle_limit_exceeded(reset_time):
wait_time = int(reset_time) - int(time.time()) + 1
print(f"Rate limit exceeded. Waiting {wait_time} seconds...")
time.sleep(wait_time)
Quelle: Zendesk Best Practices Documentation
Header in JavaScript lesen
Hier ist die gleiche Logik in JavaScript mit async/await:
const axios = require('axios');
async function callZendeskAPI() {
const url = "https://subdomain.zendesk.com/api/v2/tickets";
const headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"};
try {
const response = await axios.get(url, { headers });
const shouldContinue = handleRateLimits(response);
if (shouldContinue) {
// Process the API response
}
} catch (error) {
console.error(error);
}
}
function handleRateLimits(response) {
const accountLimit = response.headers["ratelimit-remaining"];
const endpointLimit = response.headers["Zendesk-RateLimit-endpoint"];
const accountLimitReset = response.headers["ratelimit-reset"];
if (accountLimit) {
const accountRemaining = parseInt(accountLimit);
if (accountRemaining > 0) {
if (endpointLimit) {
const endpointRemaining = parseInt(endpointLimit.split(";")[1].split("=")[1]);
if (endpointRemaining > 0) {
return true;
} else {
const endpointReset = parseInt(endpointLimit.split(";")[2].split("=")[1]);
handleLimitExceeded(endpointReset);
}
} else {
return true;
}
} else {
handleLimitExceeded(accountLimitReset);
}
}
return false;
}
async function handleLimitExceeded(resetTime) {
const waitTime = (resetTime || 60) - Math.floor(Date.now() / 1000) + 1;
console.log(`Rate limit exceeded. Waiting ${waitTime} seconds...`);
await new Promise(resolve => setTimeout(resolve, waitTime * 1000));
}
Quelle: Zendesk Best Practices Documentation
Behandeln von 429 Too Many Requests-Fehlern
Wenn Sie die Zendesk API-Ratenbegrenzung für Anfragen pro Minute überschreiten, gibt die API einen 429-Statuscode zurück. Wie Sie diese Antwort behandeln, entscheidet darüber, ob Ihre Integration ordnungsgemäß fehlschlägt oder vollständig abbricht. Weitere Informationen zum Erstellen robuster Integrationen finden Sie in unserem Leitfaden zu besten KI-Chatbots für Zendesk.
Was 429-Fehler bedeuten
Eine 429 Too Many Requests-Antwort zeigt an, dass Sie die Ratenbegrenzung erreicht haben. Die Antwort enthält einen Retry-After-Header, der Ihnen mitteilt, wie viele Sekunden Sie vor einem erneuten Versuch warten müssen:
HTTP/1.1 429
Status: 429
Retry-After: 93
In diesem Beispiel sollten Sie 93 Sekunden warten, bevor Sie eine weitere Anfrage stellen. Das Ignorieren dieses Headers und das Fortsetzen von Anfragen kann zu Null-Fehlern führen, die das Debugging erschweren.
Quelle: Zendesk Best Practices Documentation
Exponentiellen Backoff implementieren
Implementieren Sie für Produktionsintegrationen einen exponentiellen Backoff, um Ratenbegrenzungen ordnungsgemäß zu behandeln:
import time
import random
def make_request_with_backoff(url, headers, max_retries=5):
for attempt in range(max_retries):
response = requests.get(url, headers=headers)
if response.status_code == 200:
return response
elif response.status_code == 429:
retry_after = int(response.headers.get('Retry-After', 60))
# Exponential backoff with jitter
wait_time = retry_after * (2 ** attempt) + random.uniform(0, 1)
print(f"Rate limited. Waiting {wait_time:.1f} seconds...")
time.sleep(wait_time)
else:
response.raise_for_status()
raise Exception("Max retries exceeded")
Der exponentielle Backoff-Ansatz erhöht die Wartezeit zwischen den Wiederholungsversuchen, wodurch die Wahrscheinlichkeit einer Überlastung des Servers verringert und gleichzeitig die Wahrscheinlichkeit erfolgreicher Anfragen erhöht wird.
Best Practices für die Fehlerbehandlung
Hier sind wichtige Praktiken für die Behandlung von Ratenbegrenzungen in der Produktion:
- Ignorieren Sie niemals 429-Fehler. Das Fortsetzen von Anfragen nach Erreichen der Begrenzung kann dazu führen, dass Ihre Integration mit nicht hilfreichen Null-Fehlern fehlschlägt.
- Analysieren Sie immer den Retry-After-Header. Dieser sagt Ihnen genau, wie lange Sie warten müssen.
- Implementieren Sie Circuit-Breaker-Muster für Anwendungen mit hohem Volumen. Wenn Sie ständig auf Ratenbegrenzungen stoßen, pausieren Sie Anfragen vorübergehend, anstatt sie sofort erneut zu versuchen.
- Protokollieren Sie Ratenbegrenzungsereignisse. Verfolgen Sie, wann und warum Sie auf Begrenzungen stoßen, um Optimierungsmöglichkeiten zu identifizieren.
- Entwerfen Sie für eine elegante Verschlechterung. Ihre Anwendung sollte auch dann weiterhin funktionieren, wenn API-Anfragen verzögert werden.
Überwachen der API-Nutzung in Zendesk
Neben der Überwachung von Headern in Ihrem Code bietet Zendesk Tools, um Ihre API-Nutzung im Laufe der Zeit zu verfolgen.
Das Admin Center-Dashboard verwenden
Sie können Ihre API-Nutzung im Zendesk Admin Center anzeigen:
- Gehen Sie zu Admin Center > Konto > Nutzung > API
- Zeigen Sie die 7-Tage-Zusammenfassung an, die Ihre Nutzung im Vergleich zu Ihrer Ratenbegrenzung zeigt
- Überprüfen Sie den Prozentsatz der 429-Fehler während der letzten sieben Tage
- Sehen Sie, wie oft Sie sich Ihrer Begrenzung genähert haben (90-99 % der Kapazität)
Das Dashboard zeigt API-Anfragen im Zeitverlauf mit Tabellen, die die Gesamtzahl der Anfragen nach Anrufern und Endpunkten aufschlüsseln. Der Inhalt wird täglich aktualisiert, es kann jedoch bis zu 72 Stunden dauern, bis die aktuelle Nutzung angezeigt wird.
Quelle: Managing API Usage in Your Zendesk Account
Hinweis: Das API-Nutzungs-Dashboard ist nicht für Konten verfügbar, die mehr als 2500 Anfragen pro Minute verwenden, oder für eigenständige Konten, die keinen Support enthalten.
API-Nutzungsbenachrichtigungen
Zendesk bietet Benachrichtigungen, wenn Sie sich Ihrer Ratenbegrenzung nähern:
- Warnungen bei fast erfolgter Verletzung: Warnungen, wenn API-Aufrufe zwischen 90 und 99 % Ihrer Plangrenze messen
- 429-Fehlerverfolgung: Überwachen Sie den Prozentsatz der Anfragen, die Ratenbegrenzungsfehler zurückgeben
- Tägliche Zusammenfassungen: Verfolgen Sie Trends der letzten 7 Tage
Die regelmäßige Überwachung hilft Ihnen, Muster zu erkennen und Kapazitätserhöhungen zu planen, bevor das Erreichen von Grenzwerten Ihre Abläufe beeinträchtigt.
Optimieren Ihrer API-Integration
Ein intelligentes Integrationsdesign reduziert Ihre API-Nutzung, ohne die Funktionalität zu beeinträchtigen. Hier sind bewährte Strategien, um innerhalb der Zendesk API-Ratenbegrenzung für Anfragen pro Minute zu bleiben. Wenn Sie ein tieferes Verständnis von KI-gestützten Support-Tools suchen, lesen Sie unseren Zendesk AI-Testbericht.
Batching-Anfragen
Anstatt einzelne API-Aufrufe für jedes Ticket zu tätigen, verwenden Sie Batch-Endpunkte:
- show_many-Endpunkte: Rufen Sie mehrere Tickets, Benutzer oder Organisationen in einer einzigen Anfrage ab
- Side-Loading: Verwenden Sie den Parameter
include, um zugehörige Daten (wie Ticketkommentare) in einem Aufruf abzurufen - Massenaktualisierungen: Aktualisieren Sie nach Möglichkeit mehrere Tickets mit einer einzigen Anfrage
Batching kann Ihr API-Aufrufvolumen je nach Anwendungsfall um 50-90 % reduzieren.
Caching implementieren
Zwischenspeichern Sie Daten, die sich nicht häufig ändern:
- Benutzer- und Organisationsdaten: Zwischenspeichern Sie diese stunden- oder tagelang, da sich diese selten ändern
- Ticket-Metadaten: Zwischenspeichern Sie Ticketfelder, Tags und benutzerdefinierte Felddefinitionen
- Help Center-Artikel: Zwischenspeichern Sie Artikelinhalte mit den entsprechenden Cache-Headern
Implementieren Sie die Cache-Invalidierung mithilfe von Zendesk-Webhooks, um zwischengespeicherte Daten zu löschen, wenn Änderungen auftreten, um sicherzustellen, dass Ihre Integration ohne übermäßiges Polling aktuell bleibt.
Webhooks anstelle von Polling verwenden
Das Abrufen der API nach Änderungen ist ineffizient und verbraucht schnell Ihre Ratenbegrenzung. Zendesk-Webhooks benachrichtigen Ihr System, wenn Ereignisse auftreten:
- Ticket-Ereignisse: Lassen Sie sich benachrichtigen, wenn Tickets erstellt, aktualisiert oder gelöst werden
- Benutzeränderungen: Erhalten Sie Aktualisierungen, wenn sich Benutzerprofile ändern
- Organisationsaktualisierungen: Verfolgen Sie Änderungen an der Organisationsmitgliedschaft
Webhooks machen das ständige Polling überflüssig, reduzieren die API-Nutzung drastisch und bieten gleichzeitig Echtzeit-Updates.
Inkrementelle Exporte für große Datensätze
Verwenden Sie beim Synchronisieren großer Datenmengen die Inkrementelle Export API:
- Fordern Sie nur Elemente an, die sich seit Ihrer letzten Synchronisierung geändert haben
- Verwenden Sie die cursorbasierte Paginierung für die effiziente Handhabung großer Datensätze
- Bleiben Sie innerhalb der Grenze von 10 Anfragen pro Minute (30 mit High Volume-Add-on)
Dieser Ansatz ist weitaus effizienter als das wiederholte Abrufen aller Tickets, insbesondere für Konten mit hohem Ticketvolumen.
Quelle: Zendesk Incremental Exports Documentation
Wann auf High Volume API aktualisiert werden sollte
Manchmal reicht die Optimierung nicht aus. Hier erfahren Sie, wann Sie das High Volume API-Add-on benötigen. Einen vollständigen Überblick über die Funktionen von Zendesk finden Sie in unserem Zendesk-Testbericht.
Anzeichen dafür, dass Sie das Add-on benötigen
Erwägen Sie ein Upgrade, wenn Sie Folgendes feststellen:
- Ständiges Erreichen von 700 Anfragen pro Minute bei Enterprise-Plänen
- Integrationsverzögerungen, die sich auf den Geschäftsbetrieb auswirken
- Wachsendes Ticketvolumen, das Ihre aktuelle Begrenzung übersteigt
- Mehrere Integrationen, die um denselben Ratenbegrenzungspool konkurrieren
- Häufige 429-Fehler trotz Optimierungsbemühungen
Preise und Anforderungen
Das High Volume API-Add-on:
- Erhöht Ihre Begrenzung auf 2500 Anfragen pro Minute
- Verfügbar für Zendesk Suite Growth+- und Support Professional+-Pläne
- Erfordert mindestens 10 Agentenplätze
- In Enterprise Plus-Plänen ohne zusätzliche Kosten enthalten
Quelle: About Zendesk Add-ons
Überprüfen Sie vor dem Upgrade Ihre aktuelle API-Nutzung. Viele Teams stellen fest, dass sie Ratenbegrenzungsprobleme ohne zusätzliche Kosten optimieren können.
Alternative: Lassen Sie eesel AI die Ratenbegrenzungen für Sie übernehmen
Das Erstellen und Warten einer Ratenbegrenzungskonformen Integration erfordert einen erheblichen technischen Aufwand. Wenn Sie sich lieber auf Ihr Kernprodukt konzentrieren möchten, als API-Kontingente zu verwalten, bieten wir eine Alternative.
eesel AI verbindet sich direkt mit Zendesk und übernimmt die Ratenbegrenzung automatisch. Unser System:
- Überwacht Ratenbegrenzungs-Header in Echtzeit
- Implementiert intelligente Anfragewarteschlangen und Backoff
- Verwendet optimiertes Batching, um API-Aufrufe zu minimieren
- Bietet Webhook-basierte Aktualisierungen anstelle von Polling
- Skaliert nahtlos mit Ihrem wachsenden Ticketvolumen
Anstatt benutzerdefinierten Code zu schreiben, um 429-Fehler und exponentiellen Backoff zu behandeln, konfigurieren Sie Automatisierungen in einfachem Deutsch. Wir kümmern uns um die technische Komplexität, um innerhalb der Ratenbegrenzungen von Zendesk zu bleiben, während Ihre Integrationen zuverlässig laufen. Erfahren Sie mehr über unsere Zendesk AI Agent-Funktionen.
Für Teams, die benutzerdefinierte Integrationen erstellen, bietet unsere Zendesk-Automatisierungs-API-Referenz zusätzliche technische Anleitungen.
Beginnen Sie noch heute mit dem Erstellen zuverlässiger Zendesk-Integrationen
Das Verständnis der Zendesk API-Ratenbegrenzungen ist für jedes Integrationsprojekt unerlässlich. Die wichtigsten Erkenntnisse:
- Kennen Sie Ihre Plangrenzen: 200-2500 Anfragen pro Minute, abhängig von Ihrer Stufe
- Überwachen Sie Ratenbegrenzungs-Header, um die Nutzung in Echtzeit zu verfolgen
- Implementieren Sie exponentiellen Backoff für 429-Fehler
- Verwenden Sie das Admin Center-Dashboard, um Nutzungsmuster zu verfolgen
- Optimieren Sie mit Batching, Caching und Webhooks
- Erwägen Sie das High Volume API-Add-on, wenn die Optimierung nicht ausreicht
Egal, ob Sie eine benutzerdefinierte Integration erstellen oder nach einer verwalteten Lösung suchen, die ordnungsgemäße Behandlung von Ratenbegrenzungen stellt sicher, dass Ihre Zendesk-Workflows reibungslos und ohne Unterbrechung ablaufen.
Sind Sie bereit, Ihre Zendesk-Workflows zu automatisieren, ohne sich um Ratenbegrenzungen sorgen zu müssen? Testen Sie eesel AI und lassen Sie uns die API-Komplexität übernehmen, während Sie sich darauf konzentrieren, großartige Kundenerlebnisse zu bieten.
Häufig gestellte Fragen
Share this article
Article by
Stevia Putri
Stevia Putri is a marketing generalist at eesel AI, where she helps turn powerful AI tools into stories that resonate. She’s driven by curiosity, clarity, and the human side of technology.
