# Creare un token API

Crea un token API personale per script e strumenti come rclone, scegli a cosa può accedere e revocalo quando non ti serve più.

Aggiornato: 2026-10-19  
Fonte: https://drime.cloud/it/support/integrations-and-api/api-tokens

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](https://docs.drime.cloud/authentication).

## 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**.

   ![Impostazioni, Sviluppatori, con la sezione Token di accesso API e il pulsante Crea un token](https://drime.cloud/media/01M5A9VZ3EXT7ZMZHRBK5B9MS0/7ada18a14def-web-settings-developers-tokens.png)

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](#permissions).

   ![La finestra Crea un nuovo token, con il nome del token e le schede Autorizzazioni](https://drime.cloud/media/01M59T977CYEFV0EGJSEE6Y0F7/1767ae179cc0-web-settings-developers-token-dialog.png)

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 nuovo token mostrato una sola volta, con il pulsante Copia e l'avviso di conservarlo in un luogo sicuro](https://drime.cloud/media/01M5A9VVN2VHMPSB1CPTQWH2G4/45e6a99fae24-web-settings-developers-token-shown-once.png)

> **Importante**
>
> Il token viene mostrato una sola volta: **Assicurati di conservare il token in un luogo sicuro. Dopo la chiusura di questa finestra di dialogo, il token non sarà più visibile.** Salvalo subito in un gestore di password o nella configurazione del tuo strumento. Se lo perdi, eliminalo e creane uno nuovo.

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.

| Autorizzazione | Cosa può fare il token |
| --- | --- |
| **Tutti** | Tutto ciò che il tuo account può fare tramite l'API. |
| **Sola lettura** | Leggere tutte le risorse elencate qui sotto, senza modificare nulla. |
| **Limitato** | Solo le risorse impostate su **Lette** o **Scrittura**. Tutto ciò che resta su **Nessun accesso** viene rifiutato. |

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](https://docs.drime.cloud/authentication) (in inglese). Per usare un token con rclone, consulta [Rclone, Drime CLI e WebDAV](https://drime.cloud/it/support/integrations-and-api/rclone-cli-and-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.

   ![La finestra di conferma Eliminare il token?](https://drime.cloud/media/01M5A9VQDKFSB11N67Y0PAC592/fe208ec6869e-web-settings-developers-delete-token.png)

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](https://drime.cloud/it/support/account-and-settings/sessions-and-devices).

## Se non funziona

| Cosa vedi | Cosa fare |
| --- | --- |
| **Token di accesso API** non compare in **Sviluppatori** | L'accesso all'API non è attivo per il tuo account. [Contatta l'assistenza Drime](https://drime.cloud/it/support/getting-started/contact-drime-support). |
| Hai perso il token | Non può essere mostrato di nuovo. Eliminalo, poi creane uno nuovo. |
| **Crea** mostra un errore sotto **Nome del token** | Il nome deve contenere da 3 a 100 caratteri. |
| `401` con `Unauthenticated.` | Il token manca, è sbagliato o è stato eliminato. Controlla l'header `Authorization: Bearer` oppure crea un nuovo token. |
| `403` con `This API key is missing the required scope: files.write` (o un'altra risorsa) | Il token è **Sola lettura** o **Limitato** e non ha accesso a quella risorsa. Crea un token con quella risorsa impostata su **Lette** o **Scrittura** (il messaggio la indica), oppure con **Tutti**. |
| `403` con `This endpoint cannot be accessed with a restricted API key.` | Questa parte dell'API, ad esempio le impostazioni dell'account o della fatturazione, richiede un token **Tutti**. |
| `403` con `This action is unauthorized.` | È il tuo account stesso a non essere autorizzato a farlo, qualunque sia il token. |

## Passi successivi

- [Rclone, Drime CLI e WebDAV](https://drime.cloud/it/support/integrations-and-api/rclone-cli-and-webdav)
- [Visualizzare e chiudere le sessioni dei tuoi dispositivi](https://drime.cloud/it/support/account-and-settings/sessions-and-devices)