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.

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
- Nutzen Sie Nur lesbar oder Vollzugriff mit erlaubtem REST, ohne Ordneranker und mit einer Rolle, die
access_fileshat. - 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.
- Senden Sie die Unterordneranfrage mit
workspace_idund optionalparent_id. Verlangen Sie HTTP 200 undok:true. - Jede gelieferte Zeile muss zur angefragten
parent_idgehören. Steuern Sie mithas_children, ob die Oberfläche Aufklappen anbieten soll. - Behandeln Sie
file_countals Ordnermetadatum. Erwarten Sie weder Dateiobjekte noch ein Fortsetzungsfeld. - Benötigen Sie Dateien, rufen Sie
GET /api/files?workspace_id=wks_…&folder_id=fld_…auf. Gleichen Sie dessen getrenntefolders,filesund 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.

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.