Dokumentation

Ratenbegrenzungen

Um eine faire Nutzung und Systemstabilität zu gewährleisten, setzt unsere API eine Ratenbegrenzung ein. Verschiedene Abonnementpläne haben unterschiedliche Ratenbegrenzungen.

Kontingente der Tarife

Ihr monatliches Kontingent ergibt sich aus Ihrem Tarif. Es ist ein gemeinsames Kontingent für alle Produkte, und jeder abgerechnete Aufruf zählt einmal darauf.

Free: 30.000 Anfragen im Monat, im Schnitt etwa 1.000 pro Tag, ohne Tageslimit.

Bezahlte Tarife: Starter 150.000, Pro 500.000 und Business 2.000.000 Anfragen im Monat. Enterprise ist unbegrenzt.

Demo-Endpunkt: Der schlüssellose Demo-Endpunkt erlaubt etwa 100 Anfragen pro Tag und IP-Adresse und braucht keine Registrierung.

GET /v1/demo/{ip}

Ratenbegrenzungs-Header

Alle API-Antworten enthalten Header, die Informationen über Ihren aktuellen Ratenbegrenzungsstatus liefern:

X-RateLimit-Limit: Maximale Anzahl der im aktuellen Zeitfenster erlaubten Anfragen

X-RateLimit-Remaining: Anzahl der im aktuellen Zeitfenster verbleibenden Anfragen

X-RateLimit-Reset: Zeitpunkt, zu dem das Ratenbegrenzungsfenster zurückgesetzt wird (Unix-Zeitstempel)

Ratenbegrenzung überschritten

Wenn Sie Ihre Ratenbegrenzung überschreiten, gibt die API eine Antwort 429 Too Many Requests mit folgendem Inhalt zurück:

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later.",
  "retryAfter": 60
}

Bewährte Praktiken

Backoff implementieren: Wenn Sie einen Ratenbegrenzungsfehler erhalten, implementieren Sie vor einem erneuten Versuch ein exponentielles Backoff.

Antworten zwischenspeichern: Speichern Sie API-Antworten nach Möglichkeit zwischen, um die Anzahl der Anfragen zu reduzieren.