Nicht verfügbare von verweigerten API-Dateien unterscheiden

Deuten Sie 404- und 403-Antworten zu Dateien richtig, ohne fremde Kennungen zu testen, verborgene Ressourcen offenzulegen oder fehlende Berechtigungen als Löschung zu verstehen.

Zuletzt geprüft

Screenshots zeigen die englische Oberfläche.

Eine Dateianfrage kann mit 404 antworten, um eine Ressource nicht offenzulegen. Der Status allein beweist daher keine Löschung. Prüfen Sie nur Kennungen, die Ihre Integration zuvor rechtmäßig erhalten hat.

Vier Schritte: vertrauenswürdige Datei-ID verwenden, API-Schlüssel und Workspace prüfen, Status und Fehlertext von 403 oder 404 sichern und die Ursache ohne Erraten von IDs beheben.
Vier Schritte: vertrauenswürdige Datei-ID verwenden, API-Schlüssel und Workspace prüfen, Status und Fehlertext von 403 oder 404 sichern und die Ursache ohne Erraten von IDs beheben. Screenshot in voller Größe öffnen.

Mögliche Bedeutung der Antworten

Bei GET /api/files/:id deckt 404 File not found unbekannte oder nicht auflösbare IDs, für den Anfragenden verborgene Dateien und WordPress-Website-Schlüssel außerhalb ihres Website-Ordners ab. Die gemeinsame Antwort verrät nicht, ob die Datei existiert.

Eine aufgelöste Datei kann bei fehlender Workspace-Mitgliedschaft 403 Access denied liefern. Andere 403-Antworten nennen engere Ursachen: You don't have access to the files page, This file is outside the folder you're confined to, ein strukturiertes folder_locked-Ergebnis, eine falsche Workspace-Bindung oder die API-Schlüsselberechtigung beziehungsweise das Protokoll.

Schritte

  1. Beginnen Sie mit einer zuvor an dieselbe Integration gelieferten Datei-ID. Notieren Sie den erwarteten Workspace, Ordner und die Identität des API-Schlüssels.
  2. Prüfen Sie, ob die Zugangsdaten vollständig, noch gültig, für REST API erlaubt und ohne Ordneranker sind.
  3. Vergleichen Sie die Workspace-Bindung mit dem bekannten Datei-Workspace. Prüfen Sie die aktuelle Mitgliedschaft.
  4. Rufen Sie GET /api/files/:id auf. Bewahren Sie den genauen Status und bereinigten Fehlerinhalt auf, statt beides als „fehlt“ zusammenzufassen.
  5. Beheben Sie bei 403 die genannte Berechtigungs-, Protokoll-, Bindungs-, Rollen-, Ordner- oder Sperrregel. Prüfen Sie bei 404 vertrauenswürdigen App-Zustand und dosya-Oberfläche, statt benachbarte IDs zu testen.
  6. Wiederholen Sie die bekannte ID erst nach Korrektur der Ursache. Bleibt die datenschützende 404, gilt die Datei für diesen Anfragenden als nicht verfügbar.

Sicheres Clientverhalten

Listen Sie keine geratenen file_…-Werte auf, um Fälle zu unterscheiden. Eine verborgene Datei verhält sich absichtlich wie eine fehlende. Gewöhnliche API-Schlüssel mit Ordneranker werden vor diesem Handler bei allen REST-Dateianfragen abgelehnt, selbst wenn der Anker die Datei enthält. Nutzen Sie dafür WebDAV oder S3.

Die strukturierte Sperrantwort ist HTTP 403 mit error:"folder_locked", der folder_id und lock_mode:"full_lock". Sie liefert Personen mit Zugriffsberechtigung genügend Informationen zum Entsperrverfahren. Eine verborgene Datei bleibt dagegen bei 404.

Erwartetes Ergebnis

Der Client behandelt 404 datenschützend als nicht verfügbar und zeigt berechtigten Verantwortlichen genaue 403-Ursachen. Er nutzt keine fremden Kennungen, um das Vorhandensein privater Daten abzuleiten.

Referenz zu nicht verfügbaren oder verweigerten API-Dateien: dosya-REST-API-Übersicht mit Links zum Anfordern eines API-Schlüssels und zu SDKs.
Referenz zu nicht verfügbaren oder verweigerten API-Dateien: dosya-REST-API-Übersicht mit Links zum Anfordern eines API-Schlüssels und zu SDKs. Screenshot in voller Größe öffnen.

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.