Elenca le sottocartelle dirette con l'API REST

L’endpoint delle sottocartelle restituisce solo cartelle. Usalo per caricare un livello dell’albero su richiesta; usa l’endpoint dell’elenco file quando servono anche i file.

Contratto dell’endpoint

Chiama GET /api/folders/children?workspace_id=wks_…&parent_id=fld_…. Se ometti parent_id, richiedi le cartelle alla radice. La risposta è {ok:true,folders:[…]} e contiene solo le sottocartelle dirette, senza paginazione.

Ogni riga contiene id, name, parent_id, file_count e has_children. Le colonne interne relative allo stato nascosto vengono rimosse prima della serializzazione.

Passaggi

1. Usa una chiave Sola lettura o Accesso completo che consenta REST, non sia vincolata a una cartella e appartenga a un ruolo con access_files.
2. Scegli un ID di cartella principale noto da una risposta attendibile oppure ometti il parametro per scegliere la radice dello spazio di lavoro.
3. Invia la richiesta delle sottocartelle con workspace_id e l’eventuale parent_id, poi verifica che la risposta contenga HTTP 200 e ok:true.
4. Verifica che ogni riga restituita abbia il parent_id richiesto e usa has_children per decidere se l’interfaccia debba offrire l’espansione.
5. Considera file_count come metadati della riga della cartella; non aspettarti oggetti file né un campo di continuazione in questa risposta.
6. Se servono i file, chiama GET /api/files?workspace_id=wks_…&folder_id=fld_… e confronta i suoi folders, files e i dati di paginazione separati.

Accesso e privacy

Se manca workspace_id, viene restituito workspace_id is required. Se manca l’appartenenza, la risposta è Not a member. Una cartella principale nascosta a chi effettua la richiesta restituisce 404 Folder not found; una cartella principale fuori dal sottoalbero consentito a un membro umano restituisce This folder is outside the folder you're confined to.

Per un membro umano limitato a una cartella, se ometti parent_id, la radice dell’elenco coincide con la cartella a cui è vincolato il membro. È diverso dal vincolo a una cartella di una chiave API: una normale credenziale vincolata viene rifiutata su REST e deve usare WebDAV o S3.

L’endpoint non restituisce ricorsivamente i discendenti. Chiamalo di nuovo con un ID restituito per cui has_children sia valutato come vero.

Risultato previsto

Il corpo contiene solo le cartelle visibili subito sotto la cartella principale scelta. Per recuperare i file, paginarli ed espandere i livelli più profondi servono richieste esplicite separate.

Guide correlate

• Elenca i file con l’API
• Gestisci gli errori API