Sposta un file negli elementi eliminati tramite API

Usa DELETE /api/files/:id?trash_only=1 quando l’automazione deve eseguire un’eliminazione recuperabile. Questa protezione rende innocuo l’invio ripetuto. Un DELETE senza parametri dipende dallo stato: sposta nel cestino un file attivo, ma elimina definitivamente un file già nel cestino.

Prima di iniziare

• Usa una chiave API con accesso completo. Il tuo ruolo nello spazio di lavoro deve includere delete_own_files per i tuoi file o delete_any_file per quelli di altri proprietari.
• Registra ID, nome, numero di versioni e cartella padre prima dell’eliminazione.
• Gli elementi eliminati continuano a occupare spazio di archiviazione fino alla cancellazione definitiva, che è irreversibile.

Passaggi

1. Leggi i metadati del file e verifica che l’ID appartenga allo spazio di lavoro previsto. Fermati se è già eliminato, a meno che il processo non gestisca esplicitamente quello stato.
2. Invia DELETE /api/files/file_id?trash_only=1 con la chiave bearer. Escludi permanent=1 dalla richiesta; i due parametri non devono essere combinati.
3. Accetta { "ok": true, "permanent": false } per la prima operazione di spostamento nel cestino. Una richiesta sicura ripetuta può restituire { "ok": true, "already_trashed": true }.
4. Interroga GET /api/files?deleted=1 e trova lo stesso ID. La sola assenza dall’elenco normale non basta come prova: anche filtri e paginazione possono nascondere un elemento.
5. Conserva la ricevuta dello spostamento nel cestino con il record del processo. Non inviare un secondo DELETE senza parametri come tentativo generico: il server interpreterebbe lo stato nel cestino come autorizzazione a cancellare definitivamente.
6. Se la rimozione definitiva è esplicitamente approvata, invia DELETE /api/files/file_id?permanent=1 e verifica la scomparsa dall’elenco degli eliminati. La cancellazione del file e di tutte le sue versioni è irreversibile.

Risultato previsto

La richiesta sicura sposta un file attivo negli elementi eliminati e, se ripetuta, riporta already_trashed invece di cancellarlo definitivamente. Lo spazio occupato diminuisce solo dopo una cancellazione definitiva richiesta separatamente.

Risoluzione dei problemi

Il file non è nell’elenco degli eliminati. Controlla paginazione, spazio di lavoro e stato della risposta prima di riprovare.

Risposta 403. Verifica l’accesso completo della chiave, i permessi di proprietà e le regole di blocco.

La risposta a un DELETE senza parametri è andata persa. Esamina gli elenchi normale e degli eliminati prima di una nuova chiamata. Non ripetere la richiesta senza parametri se l’elemento potrebbe essere già nel cestino.

Guide correlate

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