API-Referenz
Anfragelimits und gleichzeitige Aufgaben
Anfragelimits, Aufgabenlimits und Umgang mit 429.
Limits#
| Limit | Wert | Gilt für |
|---|---|---|
| Erstellungsanfragen | 20 pro Minute | Jeden API-Schlüssel bzw. jeden OAuth-Client und jedes Konto, über alle POST-Endpunkte hinweg |
| Erstellungsanfragen | 40 pro Minute | Jedes Konto, über alle seine Zugangsdaten hinweg |
| Leseanfragen | 120 pro Minute | Jeden API-Schlüssel bzw. jeden OAuth-Client und jedes Konto |
| Laufende Aufgaben | Je nach Tarif; siehe GET /credits | Jedes Konto, gemeinsam mit der Website |
| Aufgaben pro Stunde | 200 pro gleitender Stunde | Jedes Konto, gemeinsam mit der Website |
| Rasterkonvertierungen | 200 pro Tag | Jedes Konto |
| Texterkennungen | 20 pro 15 Minuten | Jedes Konto, gemeinsam mit der Website |
| Begrenzte Wartezeit | 30 Sekunden | Jede Anfrage |
Umgang mit 429#
- Antworten auf Anfragen, die Authentifizierung und Berechtigungsprüfung bestehen, enthalten
X-RateLimit-Limit,X-RateLimit-RemainingundX-RateLimit-Resetfür das strengste Anfragezeitfenster. Bei401und403 SCOPE_DENIEDfehlen diese Header. Eine429-Antwort enthältRetry-Afterin Sekunden. 429 CONCURRENCY_LIMITEDbedeutet, dass für das Konto bereits zu viele Aufgaben laufen; abgeschlossene Aufgaben zählen nicht mehr.429 RATE_LIMITEDhat die unten aufgeführten Ursachen.- Warten Sie mindestens
Retry-After, verlängern Sie die Abstände exponentiell mit zufälliger Streuung und wiederholen Sie die Anfrage mit demselbenIdempotency-Key. - Aufgabenlimits gelten für das Konto: Weitere Schlüssel erhöhen die Kapazität nicht.
Ursachen für 429#
- Zu viele Anfragen: 20 Erstellungsanfragen pro Minute und Zugangsdaten, 40 pro Konto, 120 Leseanfragen pro Minute und Zugangsdaten.
Retry-Aftergibt die Zeit bis zum Zurücksetzen des Zeitfensters an;details.reasonist nicht vorhanden. - In der letzten Stunde wurden zu viele Aufgaben gestartet: höchstens 200 pro Konto, gemeinsam mit der Website.
Retry-After: 30. - Zu viele Aufgaben laufen gleichzeitig:
429 CONCURRENCY_LIMITED, je nach Tarif und gemeinsam mit der Website; sieheGET /credits.Retry-After: 30. - Das Tageskontingent von 200 kostenlosen PNG-, PDF-, TIFF- und PPTX-Konvertierungen ist ausgeschöpft:
details.reason = DAILY_CONVERSION_LIMIT,Retry-Afterbis zum Zurücksetzen des Tagesfensters. - Uploads erfolgen zu schnell:
details.reason = UPLOAD_RATE_LIMITEDfür Bilder und Masken anPOST /files, Flussdiagrammanhänge und Diagrammdaten. Es gilt das Uploadlimit pro Minute der Website. - Zu viele Uploads an einem Tag:
details.reason = UPLOAD_DAILY_LIMIT_REACHEDfür Flussdiagrammanhänge und Diagrammdaten. Es gilt das tägliche Uploadlimit der Website. - Texterkennungen: 20 je 15 Minuten und Konto, gemeinsam mit der Website.