Creare un token API

Un token API permette a uno script o a uno strumento, come rclone, di accedere al tuo account Drime senza la tua password. Scegli tu cosa può fare ogni token e puoi revocarlo in qualsiasi momento.

I token personali servono per i tuoi script, i tuoi backup e i tuoi strumenti, e agiscono sul tuo account. Un'app che altri utenti Drime collegano ai propri account usa invece OAuth e non deve mai chiedere la loro password: consulta la documentazione dell'API Drime.

#Creare un token

1. Fai clic sul tuo avatar, in alto a destra, poi su Impostazioni.

2. Fai clic su Sviluppatori.

3. In Token di accesso API, fai clic su Crea un token.

   

4. In Nome del token, dai al token un nome che riconoscerai.

   Indica lo strumento o il computer che lo usa, ad esempio «rclone sul mio NAS». Il nome deve contenere da 3 a 100 caratteri.

5. In Autorizzazioni, scegli cosa può fare il token.

   • Tutti: accesso completo a tutte le risorse.

   • Sola lettura: accesso in sola lettura a tutte le risorse.

   • Limitato: accesso solo alle risorse che scegli, ognuna impostata su Nessun accesso, Lette (lettura) o Scrittura.

   Consulta Scegliere le autorizzazioni giuste.

   

6. Fai clic su Crea.

7. Fai clic su Copia per copiare il token, poi su Fatto.

   Il pulsante mostra Copiato! quando il token è negli appunti.

   

Il token compare quindi in Token di accesso API e funziona subito. Non scade: funziona finché non lo elimini.

#Scegliere le autorizzazioni giuste

Concedi a un token solo ciò di cui ha bisogno.

Un token Limitato elenca queste risorse: File (comprese le versioni e il cestino), Cartelle, Condivisione, Spazi di lavoro, Vault, Firma, Lavagne, Richieste di file, Send & Track, Contatti, Etichette e Analisi. Analisi (lo spazio di archiviazione utilizzato) è solo in lettura, quindi le sue opzioni sono Nessun accesso e Accesso. Passa il mouse sull'icona di aiuto accanto a una risorsa per vedere cosa comprende.

Solo un token Tutti può accedere alle impostazioni dell'account, della sicurezza e della fatturazione. I token Sola lettura e Limitato non possono mai farlo.

Le autorizzazioni di un token non si possono modificare dopo la creazione. Per cambiarle, crea un nuovo token con le autorizzazioni giuste, aggiorna il tuo strumento, poi elimina il vecchio token.

#Usare il token

Invia il token nell'header Authorization di ogni richiesta:

Authorization: Bearer YOUR_ACCESS_TOKEN

Il link Documentazione accanto a Token di accesso API apre la documentazione dell'API Drime (in inglese). Per usare un token con rclone, consulta Rclone, Drime CLI e WebDAV.

#Visualizzare ed eliminare i tuoi token

Token di accesso API elenca i token che hai creato e quelli che le app Drime creano per sé: Drime Desktop, Drime Mobile e l'estensione del browser. Ogni riga mostra:

• il nome del token, oppure l'app e la sua piattaforma, ad esempio App desktop · Windows;

• la sua autorizzazione, ad esempio Accesso completo;

• quando è stato usato l'ultima volta, oppure Mai usato.

Se non ne hai, la sezione mostra Non hai ancora token di accesso personali.

Per revocare un token:

1. Fai clic su Elimina il token (l'icona del cestino) alla fine della sua riga.

   

2. Fai clic su Elimina per confermare.

   La finestra avvisa: Questo token verrà eliminato immediatamente e definitivamente. Una volta eliminato, non potrà più essere utilizzato per effettuare richieste API. Compare Token eliminato e qualsiasi strumento che usa quel token smette subito di funzionare.

Puoi anche disconnettere le app Drime da Visualizzare e chiudere le sessioni dei tuoi dispositivi.

#Se non funziona

#Passi successivi

• Rclone, Drime CLI e WebDAV

• Visualizzare e chiudere le sessioni dei tuoi dispositivi