Crea una cartella via API e verifica la cartella padre

La creazione di una cartella accetta un singolo nome o un percorso annidato. La risposta distingue la cartella finale, ora esistente, dai segmenti di percorso effettivamente creati dalla richiesta.

Requisiti di accesso

Usa una chiave Accesso completo con la superficie API REST, così la stessa credenziale può creare e poi leggere le cartelle. Solo caricamento può chiamare la route di creazione ma non eseguire la GET di verifica. Una chiave può essere vincolata allo spazio di lavoro di destinazione; aggiungere un vincolo a una cartella disabilita l’uso REST.

Il ruolo del membro richiede create_folders per la modifica e access_files per elencare le sottocartelle.

Passaggi

1. Scegli una cartella padre visibile e copia l’identificatore fld_…, oppure ometti parent_id per creare la cartella alla radice dello spazio di lavoro.
2. Scegli un nome di prova univoco composto da un solo segmento, lungo al massimo 100 caratteri, affinché il created_count previsto sia inequivocabile.
3. Invia POST /api/folders con { "workspace_id":"wks_…", "parent_id":"fld_…", "name":"API verification" }.
4. Verifica che la risposta sia HTTP 201 e registra folder.id, folder.parent_id, created_count e l’array created_folders.
5. Chiama GET /api/folders/children?workspace_id=wks_…&parent_id=fld_…; ometti parent_id solo se la cartella padre scelta è la radice dello spazio di lavoro.
6. Trova una sola cartella restituita il cui ID sia uguale a folder.id, poi confronta nome e cartella padre prima di conservare la cartella di prova o spostarla nel cestino.

Comportamento dei percorsi

La route di creazione separa i segmenti sia con / sia con \, quindi Reports/2026/October può creare più livelli in una sola richiesta. Il percorso completo è limitato a 500 caratteri e ogni segmento a 100. I segmenti esistenti vengono riutilizzati: una ripetizione riuscita può restituire created_count:0 e un percorso misto può segnalare meno cartelle create dei segmenti.

Il corpo della risposta 201 contiene la cartella finale come folder:{id,name,parent_id,workspace_id}. created_folders contiene solo le righe inserite da quella richiesta. La creazione modifica subito l’albero dello spazio di lavoro; rimuovere la cartella di prova in seguito è un’operazione separata.

Risultato previsto

L’ID della cartella finale nella risposta di creazione appare tra le sottocartelle dirette della cartella padre richiesta. Una prova univoca con un solo segmento restituisce created_count:1 e una voce in created_folders.

Risoluzione dei problemi

workspace_id is required o Folder name is required indica che il corpo è incompleto. Gli errori di appartenenza e ruolo riportano Not a member of this workspace o You don't have permission to create folders. Destinazioni mancanti o bloccate restituiscono Parent folder not found o una risposta strutturata folder_locked. Una condizione di concorrenza può produrre 409 A folder named "<part>" already exists here; elenca le sottocartelle della cartella padre prima di decidere se riprovare.

Guide correlate

• Usa le operazioni sulle cartelle
• Guida rapida all’API REST