API-Aufrufbeschränkungen
Um eine optimale Serviceumgebung für alle Nutzer zu gewährleisten, wendet Vivoldi planabhängige API-Aufrufbeschränkungen an.
Bei Überschreitung des Limits wird der Fehler HTTP 429 (Too Many Requests) ausgegeben. Bitte warten Sie in diesem Fall einen Moment, bevor Sie die Anfrage erneut senden.
API-Anfragelimits nach Tarif
Die folgende Tabelle zeigt die API-Anfragelimits pro Minute und pro Stunde für die jeweiligen Tarife.
Das verfügbare Anfragevolumen kann je nach Servicegröße und Traffic-Muster variieren. Zur Sicherstellung einer stabilen und zuverlässigen API-Performance gelten entsprechende Rate-Limiting-Richtlinien.
| Tarif | Max pro Minute | Max pro Stunde | Statistik-API / Min. | Statistik-API (gleichzeitig) |
|---|---|---|---|---|
| Kostenlos | 30 | 600 | 5 % des Basislimits | — |
| Persönlich | 180 | 10,000 | 5 % des Basislimits | 1 |
| Prämie | 300 | 15,000 | 5 % des Basislimits | 1 |
| Business | 480 | 25,000 | 5 % des Basislimits | 2 |
| Business-Plus | 768 | 40,000 | 5 % des Basislimits | 2 |
| Enterprise | 1,200 | 60,000 | 5 % des Basislimits | Vertragsabhängig (Standard: 3) |
Umgang mit überschrittenen API-Anfragelimits
Wird das API-Anfragelimit überschritten, gibt der Server eine HTTP 429 (Too Many Requests)-Antwort zurück.
Für einen stabilen und zuverlässigen Servicebetrieb empfehlen wir, die Request-Logik anhand der folgenden Best Practices zu implementieren.
1. Retry-Logik implementieren (Retry with Backoff)
Wenn eine 429-Antwort empfangen wird, sollte die Anfrage nach einer kurzen Wartezeit erneut gesendet werden.
Anstelle häufiger Wiederholungen in kurzen Intervallen empfehlen wir ausdrücklich die Verwendung einer Exponential Backoff-Strategie.
2. Request-Frequenz optimieren
Werden dieselben Daten wiederholt angefragt, können unnötige API-Aufrufe durch den Einsatz von Cache-Mechanismen reduziert werden.
Für umfangreiche Prozesse ist Batch-Verarbeitung in der Regel effizienter als einzelne Requests nacheinander auszuführen.
3. Vorbereitung auf hohe API-Auslastung
Wenn Ihre Umgebung regelmäßig die API-Limits erreicht, sollten Sie einen höheren Tarif oder die Business Plus- bzw. Enterprise-Pläne mit flexibleren Request-Limits in Betracht ziehen.
Flexible Limits für Business Plus und Enterprise
Die Business Plus- und Enterprise-Tarife verwenden ein flexibles API-Skalierungsmodell, bei dem sich die Request-Limits automatisch anhand des monatlichen Linkvolumens erweitern, anstatt auf festen Limits zu basieren.
Dieses Modell eignet sich ideal für Marketingplattformen, eCommerce-Dienste und Unternehmenssysteme mit großen Linkmengen und wurde entwickelt, um auch in Umgebungen mit hohem Traffic flexibel und stabil zu funktionieren.
- Basis-Standard: 10.000 Links pro Monat
- Zur Sicherung der Systemstabilität ist die maximale Erweiterung auf das 3,5-Fache des Basis-Limits begrenzt.
Beispiel (Enterprise-Tarif)
- 10.000 Links/Monat → 1.200 Aufrufe/Min. / 60.000 Aufrufe/Std.
- 30.000 Links/Monat → 2.000 Aufrufe/Min. / 100.000 Aufrufe/Std.
※ Für Webhook-Aufrufe gelten 80 % des regulären API-Limits.
※ Die tatsächlichen Limits können je nach Vertragsbedingungen variieren. Für höhere Kapazitäten kontaktieren Sie uns bitte.