Rinomina un file tramite l'API REST

PUT /api/files/:id/rename modifica il nome archiviato mantenendo ID del file, cartella padre e cronologia delle versioni. L’estensione fa parte di name; modificarla può cambiare il modo in cui i client classificano il file o ne mostrano l’anteprima.

Prima di iniziare

• Usa una chiave API con accesso completo e un ruolo nello spazio di lavoro con rename_files.
• Leggi ID, cartella padre, stato del blocco e nome del file.
• Scegli un nome di 1–255 caratteri dopo aver eliminato gli spazi ai margini. Non può includere /, \ o caratteri di controllo C0, né consistere solo in . o ...

Passaggi

1. Recupera GET /api/files/file_id e conserva l’ID della cartella padre. Se l’estensione conta, includi esplicitamente quella desiderata nel nuovo nome.
2. Crea il corpo JSON esatto, per esempio {"name":"Q4 forecast.pdf"}. Virgolette e parentesi angolari sono ammesse; i client devono comunque applicare correttamente l’escape JSON.
3. Invia PUT /api/files/file_id/rename con autorizzazione bearer e Content-Type: application/json. Tieni questa chiamata separata da altre operazioni in blocco.
4. Verifica che la risposta sia HTTP 200 e { "ok": true, "name": "Q4 forecast.pdf" }. Considera 400 come input non valido, 403 come rifiuto per ambito, ruolo o blocco, 404 come non disponibile e 409 come conflitto di nome nella stessa cartella.
5. Leggi di nuovo lo stesso ID file e verifica che name sia cambiato mentre l’ID della cartella padre è rimasto invariato. Usa l’eventuale X-D1-Bookmark restituito per i controlli basati su D1, senza considerarlo una garanzia di ordinamento per il contenuto dell’oggetto dello spazio di lavoro.
6. Apri o scarica il file rinominato se l’estensione è cambiata. Questo controllo rileva un’automazione che ha modificato per errore il suffisso anche se i byte sono rimasti intatti.

Risultato previsto

La ricevuta di successo riporta il nome normalizzato. Una nuova lettura dei metadati mostra lo stesso ID file e la stessa cartella padre con il nuovo nome; le versioni rimangono associate a quell’ID.

Risoluzione dei problemi

Il server restituisce 400. Elimina gli spazi ai margini. Controlla lunghezza, barre, caratteri di controllo, . e ...

Il server restituisce 409. Un altro elemento nella stessa cartella usa già il nome richiesto. Scegli un altro nome o risolvi il conflitto prima di una nuova richiesta.

Il server restituisce 403. Verifica l’accesso completo della chiave, rename_files e che il file non sia bloccato per chi effettua la chiamata.

Guide correlate

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