Klantly Developers

Rate Limits

Wie viele Anfragen Sie stellen dürfen, wie Sie sehen, wo Sie stehen, und wie Sie sauber drosseln.

Limits

LimitAnzahlBeschreibungZeitfenster (Sekunden)
key_minute120Anfragen pro Minute für diesen Schlüssel60
company_minute300Anfragen pro Minute für dieses Unternehmen60
company_writes60Schreibvorgänge pro Minute für dieses Unternehmen60
company_heavy10aufwendige Aktionen pro Minute für dieses Unternehmen60
company_day50.000Anfragen pro Tag für dieses Unternehmen86400
auth_failures20fehlgeschlagene Anmeldungen pro Minute von dieser IP-Adresse60

Das Limit pro Unternehmen gilt für alle Schlüssel Ihres Unternehmens zusammen. Schreibvorgänge (POST, PATCH, DELETE) zählen zusätzlich zum Schreiblimit. Brauchen Sie dauerhaft mehr? Wenden Sie sich an den Support.

Jede Antwort zeigt Ihnen, wo Sie stehen:

Header Bedeutung
RateLimit-Policy Alle Limits, die für diese Anfrage gelten
RateLimit Verbleibende Anfragen und Sekunden bis zum Zurücksetzen, für das knappste Limit
X-RateLimit-Limit Größe des knappsten Limits
X-RateLimit-Remaining Im aktuellen Zeitfenster noch verfügbar
X-RateLimit-Reset Unix-Zeit, zu der das Zeitfenster neu beginnt

Bei einem 429

Ein 429 rate_limited hat einen Header Retry-After mit der Anzahl Sekunden, die Sie warten müssen. Das Feld limit in der Antwort nennt das Limit, das Sie erreicht haben.

JavaScript
async function request(url, options, attempt = 0) {
  const response = await fetch(url, options);

  if (response.status === 429 && attempt < 5) {
    const seconds = Number(response.headers.get('Retry-After') ?? 1);
    await new Promise((resolve) => setTimeout(resolve, seconds * 1000));

    return request(url, options, attempt + 1);
  }

  return response;
}

Tipp

Verteilen Sie große Synchronisierungen über die Zeit und verwenden Sie limit=100, dann rufen Sie mit weniger Anfragen mehr ab.

Zuletzt aktualisiert am 14. September 2026