Direkte Unterordner über die REST-API auflisten

Listen Sie nur direkte Unterordner eines Ordners auf. Prüfen Sie die Metadaten jeder Zeile und verwenden Sie für Dateien den separaten Dateilisten-Endpunkt.

Zuletzt geprüft

Screenshots zeigen die englische Oberfläche.

Der Unterordner-Endpunkt liefert nur Ordner. Laden Sie bei Bedarf eine Ebene des Ordnerbaums nach. Werden auch Dateien benötigt, nutzen Sie den Dateilisten-Endpunkt.

Vier Schritte: übergeordneten Ordner wählen, direkte Unterordner anfordern, mit has_children das Aufklappen steuern und für Dateien zu GET files wechseln.
Vier Schritte: übergeordneten Ordner wählen, direkte Unterordner anfordern, mit has_children das Aufklappen steuern und für Dateien zu GET files wechseln. Screenshot in voller Größe öffnen.

Vertrag des Endpunkts

Rufen Sie GET /api/folders/children?workspace_id=wks_…&parent_id=fld_… auf. Ohne parent_id werden Stammordner angefordert. Die Antwort {ok:true,folders:[…]} enthält nur direkte Unterordner und keine Seitenaufteilung.

Jede Zeile enthält id, name, parent_id, file_count und has_children. Interne Spalten zum verborgenen Status werden vor der Serialisierung entfernt.

Schritte

  1. Nutzen Sie Nur lesbar oder Vollzugriff mit erlaubtem REST, ohne Ordneranker und mit einer Rolle, die access_files hat.
  2. Wählen Sie die bekannte ID eines übergeordneten Ordners aus einer vertrauenswürdigen Antwort. Lassen Sie den Parameter für den Workspace-Stammordner bewusst weg.
  3. Senden Sie die Unterordneranfrage mit workspace_id und optional parent_id. Verlangen Sie HTTP 200 und ok:true.
  4. Jede gelieferte Zeile muss zur angefragten parent_id gehören. Steuern Sie mit has_children, ob die Oberfläche Aufklappen anbieten soll.
  5. Behandeln Sie file_count als Ordnermetadatum. Erwarten Sie weder Dateiobjekte noch ein Fortsetzungsfeld.
  6. Benötigen Sie Dateien, rufen Sie GET /api/files?workspace_id=wks_…&folder_id=fld_… auf. Gleichen Sie dessen getrennte folders, files und Seitendaten ab.

Zugriff und Schutz der Daten

Fehlt workspace_id, erscheint workspace_id is required. Ohne Mitgliedschaft lautet die Antwort Not a member. Ist der übergeordnete Ordner für den Anfragenden verborgen, kommt 404 Folder not found. Außerhalb des einem Mitglied erlaubten Teilbaums erscheint This folder is outside the folder you're confined to.

Bei einem ordnerbeschränkten Mitglied beginnt die Liste ohne parent_id an dessen zugewiesenem Stammordner. Das ist von einem Ordneranker eines API-Schlüssels zu unterscheiden: Gewöhnliche Zugangsdaten mit solchem Anker werden über REST abgelehnt und müssen WebDAV oder S3 nutzen.

Der Endpunkt liefert keine tieferen Ebenen rekursiv. Rufen Sie ihn für eine gelieferte ID erneut auf, wenn deren has_children-Wert wahr ist.

Erwartetes Ergebnis

Der Antwortinhalt enthält nur sichtbare Ordner direkt unter dem gewählten übergeordneten Ordner. Dateiabfragen, Dateiseiten und tiefere Ebenen benötigen jeweils eigene ausdrückliche Anfragen.

Referenz für direkte Unterordner: dosya-REST-API-Übersicht mit Links zu API-Schlüsseln und SDK-Dokumentation.
Die REST-API-Übersicht liefert die Einstiege zu Zugangsdaten und SDKs vor der Abfrage direkter Unterordner. 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.