Crea e sposta cartelle con l'API REST

dosya offre route separate per creare, rinominare e spostare cartelle. Uno spostamento può anche applicare il nome finale in modo atomico, evitando un conflitto intermedio nella destinazione.

Permessi e nomi

Usa una credenziale Accesso completo con REST abilitato. La creazione richiede il permesso di ruolo create_folders; rinomina e spostamento richiedono rename_folders; la verifica tramite elenco richiede access_files. Un vincolo allo spazio di lavoro funziona; il vincolo a una cartella della chiave API non funziona su REST.

Un percorso di creazione può contenere 500 caratteri distribuiti in più segmenti. I nomi per rinomina e spostamento sono singoli segmenti di massimo 100 caratteri.

Passaggi

1. Crea una cartella sorgente di prova con POST /api/folders e conserva l’ID della cartella finale restituita e il suo parent_id originale.
2. Rinominala con PUT /api/folders/:id/rename usando { "name":"Quarterly archive" }, poi verifica che la risposta sia { "ok":true,"name":"Quarterly archive" }.
3. Scegli una cartella di destinazione visibile fuori dal sottoalbero sorgente che non contenga già il nome finale.
4. Sposta la cartella con PUT /api/folders/:id/move e { "parent_id":"fld_destination","name":"Published archive" }; usa null per spostarla alla radice dello spazio di lavoro.
5. Verifica che la risposta di spostamento riporti il name finale, compresa l’eventuale rinomina atomica anziché il vecchio nome sorgente.
6. Elenca le sottocartelle dirette della destinazione e verifica che l’ID della cartella compaia una sola volta e non sia più nell’elenco della cartella padre precedente.

Errori da gestire

Una destinazione coincidente con la cartella stessa restituisce Cannot move a folder into itself; una destinazione discendente restituisce Cannot move a folder into its own subfolder. dosya riporta Destination folder not found se la destinazione è assente o nascosta e You don't have permission to move folders se il ruolo corrente non consente l’operazione.

Uno spostamento senza effetto produce Folder is already here. Un conflitto di nome nella destinazione restituisce HTTP 409 con A folder with this name already exists in the target folder. Gli alberi di copie di sicurezza bloccati impediscono rinomina e spostamento. Non scegliere automaticamente nomi alternativi, a meno che chi effettua la chiamata non lo accetti esplicitamente.

Lo spostamento e la rinomina modificano l’albero condiviso e invalidano gli elenchi interessati. Puoi annullarli con un’altra operazione autorizzata, ma i client possono vedere subito il nuovo percorso.

Risultato previsto

La cartella mantiene lo stesso ID, la risposta di spostamento ne riporta il nome finale e l’elenco della destinazione mostra la nuova relazione con la cartella padre senza duplicati nella sorgente.

Guide correlate

• Guida rapida all’API REST
• Ambiti delle chiavi API