Connettere dosya a n8n

Il pacchetto community n8n-nodes-dosya connette n8n a dosya tramite l’API REST. Può caricare, scaricare ed elencare file, creare o riutilizzare cartelle e creare link di condivisione per file o cartelle.

Requisiti e limiti

• Il pacchetto nel repository è n8n-nodes-dosya versione 0.1.1. La compatibilità prevista è con n8n 2.42 e Node.js 22; la disponibilità dell’installazione dei nodi community dipende comunque dalle regole della tua installazione n8n.
• Il nodo usa una chiave API dosya, mai la password di dosya. Per tutte e cinque le operazioni attuali usa Accesso completo, includi il protocollo API REST e lascia Accesso alle cartelle non impostato. Puoi vincolare la chiave a uno spazio di lavoro.
• Restano validi appartenenza e ruolo del proprietario della chiave nello spazio di lavoro. L’ambito di accesso completo non consente azioni vietate al membro.
• Le operazioni attuali sono File: Upload, File: Download, File: Get Many, Folder: Create e Share Link: Create. Questa versione non ha operazioni dosya per trigger, eliminazione, spostamento, rinomina, sincronizzazione o richieste di file.
• dosya applica i limiti del piano e dello spazio di lavoro. I valori predefiniti nel codice per il piano gratuito prevedono 5 GB di spazio di archiviazione e 100 GB di traffico in uscita al giorno, consentono al massimo 5 link di condivisione attivi e limitano la scadenza dei link a 7 giorni. I limiti dello spazio di lavoro e dei singoli file possono essere più restrittivi.

Passaggi

1. In un’istanza n8n ospitata da te che consente pacchetti community, apri Settings → Community Nodes → Install.
2. Inserisci n8n-nodes-dosya e conferma l’installazione. Dopo l’installazione il selettore dei nodi dovrebbe contenere dosya.dev e quello delle credenziali dosya.dev API.
3. In dosya apri Profilo → Chiavi API → Crea una chiave API. Assegna alla chiave un nome per questa istanza n8n, scegli Accesso completo, limita Protocolli a API REST e, se vuoi, vincolala a uno spazio di lavoro.
4. Genera la chiave e copia il segreto mostrato una sola volta. Non aggiungere un ancoraggio a una cartella: l’API rifiuta chiavi ancorate a cartelle fuori da WebDAV e S3.
5. In n8n crea una credenziale dosya.dev API e inserisci il token in API Key. Il salvataggio la verifica rispetto a GET https://api.dosya.dev/api/me.
6. Crea un flusso temporaneo e aggiungi un nodo dosya.dev. Scegli la credenziale salvata, File come Risorsa e Get Many come Operation.
7. In Spazio di lavoro, usa From List e seleziona il nome desiderato. Scegli radice dello spazio di lavoro in Cartella, lascia disattivato Return All e imposta un Limit ridotto, per esempio 1.
8. Esegui il nodo. Confronta workspace_id, folder_id, id, name e type restituiti con l’elemento innocuo atteso prima di aggiungere operazioni di scrittura.

Risultato previsto

La verifica della credenziale riesce e l’esecuzione di prova Get Many restituisce dalla radice selezionata al massimo il numero di elementi scelto. Il nodo riceve solo le risorse accessibili al proprietario della chiave entro il vincolo dello spazio di lavoro e il suo ruolo.

I selettori di risorse supportano From List e By ID. Gli ID degli spazi di lavoro iniziano con ws_, quelli delle cartelle con fld_ e quelli dei file con file_. Le cartelle mostrano percorsi come Clients / Acme / Final; una ricerca di file senza testo elenca i file più recenti nella radice, mentre un testo cerca nell’intero spazio di lavoro selezionato in pagine da 50.

Diagnosticare una connessione non riuscita

• dosya.dev did not accept the API key indica che il token può essere incompleto, scaduto o revocato. Sostituisci la credenziale salvata in n8n con un segreto valido mostrato una sola volta.
• This key is read-only. Uploads, folders and share links need a key with Full access scope. viene mostrato dalla verifica della credenziale per una chiave in sola lettura, anche se GET /api/me ha autenticato la richiesta.
• Un 403 che menziona api surface indica che la chiave esclude REST. Genera una chiave che includa API REST.
• Un 403 che indica che la chiave è anchored at a folder richiede una sostituzione senza ancoraggio a una cartella; per usarla come destinazione selezionala nel nodo.
• No workspace selected è un errore di convalida n8n. Scegli uno spazio di lavoro dall’elenco o inserisci il suo identificatore ws_….
• Se uno spazio di lavoro manca, la chiave potrebbe essere vincolata altrove o il proprietario potrebbe non farne parte. Una credenziale valida non garantisce l’accesso a ogni spazio di lavoro.
• Il client riprova un 429 per un massimo di 3 tentativi quando Retry-After è di 30 secondi o meno. Un’attesa più lunga viene segnalata all’esecuzione invece di tenere il processo in attesa senza avviso.

Rimuovere il pacchetto n8n non revoca la sua chiave dosya. La revoca è permanente, ma una convalida già riuscita e memorizzata nella cache può restare accettata fino a 5 minuti. Individua i flussi interessati prima della rotazione, poi riprova dopo tale intervallo.

Guide correlate

• Scegliere il permesso della chiave API
• Connettere Zapier