Creare un flusso n8n sicuro per i file

Crea un flusso dosya attorno a un’operazione esplicita e controlla un’esecuzione manuale prima dell’attivazione. Il nodo community offre azioni ma non ha un trigger dosya, quindi il flusso inizia con un trigger n8n o un’applicazione a monte.

Scegli consapevolmente l’operazione

Risorsa e operazione	Input ed effetto
File → Carica	Legge un campo binario in ingresso, predefinito su data, e lo archivia in Spazio di lavoro e Cartella scelti. Un file con lo stesso nome nella cartella riceve una nuova versione.
File → Scarica	Usa un ID file scelto o mappato e scrive i byte in Output Data Field Name per i nodi successivi.
File → Get Many	Elenca una cartella o radice dello spazio di lavoro. Return All scorre tutte le pagine; altrimenti Limit è impostato su 50 per impostazione predefinita.
Cartella → Crea	Crea la cartella indicata in Parent Folder oppure restituisce quella esistente. La sostituzione facoltativa delle barre mantiene nomi come A/B in un’unica cartella.
Condividi link → Crea	Crea un nuovo link pubblico a un file o una cartella, eventualmente con scadenza, codice di accesso di almeno 8 caratteri e Solo lettura. Ogni chiamata riuscita crea un altro link.

Usa From List per configurare una destinazione fissa. Usa By ID o un’espressione quando un nodo precedente fornisce un ID: l’identificatore è più stabile del nome visualizzato.

Passaggi

1. Crea un flusso n8n e aggiungi un trigger manuale o specifico dell’applicazione. Recupera un elemento di prova eliminabile per vedere i suoi campi JSON e binari.
2. Aggiungi dosya.dev, scegli Risorsa e Operation, poi la credenziale dedicata dosya.dev API.
3. Scegli Spazio di lavoro e la destinazione Cartella. Un valore cartella vuoto o radice dello spazio di lavoro indica il primo livello. Per download e condivisione basta un ID di destinazione mappato; Spazio di lavoro serve solo a esplorare i rispettivi selettori.
4. Per Carica, controlla la scheda Binary del nodo precedente e inserisci il nome del campo in Input Data Field Name. I valori comuni includono data e nomi degli allegati Gmail come attachment_0. Lascia vuoto Nome file per mantenere il nome in ingresso, oppure mappa un nome sostitutivo intenzionale.
5. Esegui solo il nodo dosya. Controlla l’output prima di collegare le fasi successive. Il caricamento restituisce id, name, size, mime_type, version, is_new_version, workspace_id, folder_id, created_at, hash_verified, deduplicated e upload_method.
6. Aggiungi diramazioni o un flusso di errore per le operazioni rifiutate. Non includere credenziali o contenuto dei file nei messaggi di errore; conserva stato HTTP, messaggio dosya e ID dell’esecuzione n8n.
7. Prova lo stesso input una seconda volta solo dopo aver letto le regole sugli effetti riportate sotto. Conferma il risultato nella cartella dosya prevista, poi attiva il flusso.

Risultato previsto

L’esecuzione manuale modifica solo la destinazione scelta e restituisce identificatori mappabili dalle fasi successive. Per un caricamento, hash_verified: true conferma che dosya ha verificato la corrispondenza dello SHA-256 fornito; is_new_version: true identifica una versione con lo stesso nome e deduplicated: true la ripetizione di una richiesta idempotente nella stessa esecuzione.

La creazione della cartella restituisce created: false quando viene riutilizzata una cartella esistente con lo stesso nome. La creazione della condivisione restituisce url, target_type, target_id, expires_at, view_only, access_code_required, access_mode e created_at. Invia il link restituito solo dopo averne controllato destinazione e restrizioni.

Tempi, tentativi ed effetti delle ripetizioni

• I file fino a 50 MiB (52.428.800 byte) usano una richiesta di caricamento con checksum e timeout di 10 minuti. I file più grandi usano parti da 10 MiB (10.485.760 byte) e vengono completati dopo la riuscita di tutte le parti.
• Le richieste normali hanno un timeout di 60 secondi. Per 429, il nodo rispetta Retry-After fino a 30 secondi e si ferma dopo 3 tentativi complessivi.
• Le letture autenticate, inclusa la richiesta di un URL di download firmato e temporaneo, la creazione di cartelle e le parti di caricamento possono essere ritentate dopo una connessione interrotta o 502, 503 o 504. Il download separato dei byte da quell’URL firmato ha un timeout di 10 minuti e nessun nuovo tentativo interno; controlla l’errore e riesegui il nodo. La creazione di cartelle è sicura da ripetere perché il server riutilizza un nome esistente.
• Un caricamento con una richiesta usa una chiave di idempotenza derivata da esecuzione, nodo, destinazione, nome e contenuto del file. Retry On Fail di n8n nella stessa esecuzione può ricevere il caricamento completato senza scriverlo due volte.
• Create Share Link non viene ritentato dopo un errore di rete dal risultato incerto. Controlla dosya prima di riprovare: un altro tentativo può produrre un secondo link attivo.
• Rieseguire l’intero flusso crea una nuova esecuzione. Un caricamento ripetuto con lo stesso nome crea un’altra versione e una fase di condivisione ripetuta crea un altro URL.

L’attivazione fa sì che gli eventi futuri del trigger producano effetti esterni. Caricare o creare una cartella può modificare lo stato condiviso dello spazio di lavoro; i destinatari possono aprire un URL di condivisione fino alla scadenza o alla revoca. Disattivare il flusso ferma le nuove esecuzioni n8n ma non rimuove file, versioni, cartelle o link già creati.

Errori comuni

• No workspace selected, No file selected o Nessuna cartella indicano che il selettore richiesto ha restituito un valore vuoto. Controlla l’espressione usando l’elemento che ha causato l’errore.
• The folder name is empty indica che il nome o la sua espressione non contiene alcun segmento utilizzabile.
• The access code is shorter than 8 characters segnala che il codice è troppo corto; il controllo avviene prima della richiesta di condivisione. Allunga il codice del destinatario.
• Un 401 diventa dosya.dev did not accept the API key. Sostituisci la credenziale scaduta, revocata o digitata male.
• Un 403 può indicare ambito della chiave, permesso del membro, vincolo allo spazio di lavoro o ancoraggio a cartella non supportato. Segui il messaggio specifico del server invece di ampliare ogni restrizione.
• Un 404 può indicare un ID errato, un elemento eliminato o nel cestino oppure invisibile alla chiave.
• Un 413 indica che il file supera un limite per file del piano, dello spazio di lavoro o della chiave API. Gli errori sul limite di spazio indirizzano il proprietario alla fatturazione o l’amministratore dello spazio di lavoro al limite configurato.

Guide correlate

• Connettere n8n
• Scegliere gli eventi webhook
• Caricare file