dosya-API-Anfragelimits behandeln
Lesen Sie die Anfragelimit-Header von dosya, beachten Sie Retry-After und ergänzen Sie eine begrenzte Zufallswartezeit. Wiederholen Sie sicher, statt bei 429 ständig neu anzufragen.
Zuletzt geprüft
Screenshots zeigen die englische Oberfläche.
dosya setzt mehrere Limits durch. Allgemeiner angemeldeter Verkehr und Uploads erlauben 300 Anfragen pro Minute und Konto, Listen 600 pro Minute. Für angemeldeten IP-Verkehr gelten außerhalb der Desktop-Synchronisierungsausnahme 600 pro Minute. Ein API-Schlüssel kann zusätzlich ein eigenes Minutenkontingent haben.

Vor dem Start
- Lassen Sie den Client Antwortstatus und Header bewahren. Ein JSON-Parser allein verliert das Wiederholungssignal.
- Entscheiden Sie, ob die Anfrage sicher wiederholbar ist. Lesen ist meist sicher. Änderungen brauchen einen routenspezifischen Nachweis oder eine Idempotenzzusage.
- Halten Sie Parallelität unter der dokumentierten Grenze. Wiederholungen ersetzen keine Steuerung.
Schritte
- Prüfen Sie jede Antwort auf
X-RateLimit-Limit,X-RateLimit-RemainingundX-RateLimit-Reset. Der allgemeine Begrenzer liefert diese Header auch bei Erfolg. - Lesen Sie bei 429 zuerst
Retry-After, dann den Inhalt. Ein API-Schlüssel kannThis API key has exceeded its requests-per-minute limitmelden. Dabei ist nurRetry-Aftergarantiert. - Warten Sie die Serverfrist und ergänzen Sie eine kleine Zufallswartezeit, damit parallele Worker nicht gemeinsam fortfahren. Begrenzen Sie fehlerhafte oder überlange Werte passend zur Jobfrist.
- Wiederholen Sie danach Lesen oder einen idempotenten Upload. Prüfen Sie bei ungewissem Verschieben, Umbenennen, Papierkorbverschieben oder anderen Änderungen den entfernten Zustand, statt automatisch zu wiederholen.
- Begrenzen Sie die Versuche. dosya CLI wiederholt höchstens dreimal. Ersatzwartezeiten sind 1, 3 und 8 Sekunden. Ein gültiges
Retry-Afterwird auf 60 Sekunden begrenzt. - Notieren Sie Route, Status, Versuch und Wartezeit ohne Zugangsdaten. Senken Sie Parallelität, wenn 429 nach einem vollen Rücksetzfenster wiederkehrt.

Erwartetes Ergebnis
Der Client wartet. Sobald wieder Kapazität verfügbar ist, ist die Anfrage erfolgreich. Ist sein Wiederholungsbudget erschöpft, stoppt er. Die Automatisierung unterscheidet API-Schlüsselkontingente von Konto- oder IP-Limits. Dabei setzt sie nicht voraus, dass die Header identisch sind.
Fehlerbehebung
Retry-After fehlt. Nutzen Sie vorsichtige exponentielle Wartezeiten mit Zufallsanteil. Die CLI nutzt ersatzweise 1, 3 und 8 Sekunden.
Eine Änderung überschreitet die Wartefrist vor der Statusantwort. Lesen Sie die Ressource oder den Bestätigungsendpunkt. Wiederholen Sie nur bei dokumentierter Idempotenz der Aktion.
429 bleibt nach dem Zurücksetzen. Senken Sie Parallelität und prüfen Sie die Minutenbegrenzung des API-Schlüssels. Ein neuer API-Schlüssel hebt Konto- oder IP-Limits nicht auf.
Weitere Anleitungen
War diese Anleitung hilfreich?
Bewertungen werden geladen …
Beim Abstimmen speichern wir ein notwendiges Abstimmungs-Cookie bis zu 180 Tage. So können Sie Ihre Antwort ändern.
Fragen und Antworten
Stellen Sie Fragen zu den Schritten dieser Anleitung. Fragen werden vor der Veröffentlichung geprüft.
Veröffentlichen Sie in Fragen keine Kontodaten, Zugangsdaten oder privaten Dateien. Nutzen Sie privaten Support für solche Angaben.
Fragen werden geladen …
Melden Sie sich bei Ihrem dosya-Konto an, um eine Frage zu stellen.