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.

Vier Schritte: Anfragelimit-Header prüfen, Retry-After lesen, nur sichere Aktionen wiederholen und drei Wartezeiten auf je 60 Sekunden begrenzen.
Vier Schritte: Anfragelimit-Header prüfen, Retry-After lesen, nur sichere Aktionen wiederholen und drei Wartezeiten auf je 60 Sekunden begrenzen. Screenshot in voller Größe öffnen.

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

  1. Prüfen Sie jede Antwort auf X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Der allgemeine Begrenzer liefert diese Header auch bei Erfolg.
  2. Lesen Sie bei 429 zuerst Retry-After, dann den Inhalt. Ein API-Schlüssel kann This API key has exceeded its requests-per-minute limit melden. Dabei ist nur Retry-After garantiert.
  3. 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.
  4. 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.
  5. Begrenzen Sie die Versuche. dosya CLI wiederholt höchstens dreimal. Ersatzwartezeiten sind 1, 3 und 8 Sekunden. Ein gültiges Retry-After wird auf 60 Sekunden begrenzt.
  6. Notieren Sie Route, Status, Versuch und Wartezeit ohne Zugangsdaten. Senken Sie Parallelität, wenn 429 nach einem vollen Rücksetzfenster wiederkehrt.
dosya-Entwicklerübersicht mit API- und SDK-Einstiegen für Anfragelimits.
Die Entwicklerübersicht liefert die in dieser Anleitung zu Anfragelimits genannten API- und SDK-Einstiege. Screenshot in voller Größe öffnen.

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.

    Ergebnis vor einem neuen Versuch prüfen

    Nutzen Sie diese Prüfungen, wenn Sie ein Ergebnis genauer kontrollieren möchten.