# Créer un token d'API

Créez un token d'API personnel pour vos scripts et outils comme rclone, choisissez ce à quoi il accède, et révoquez-le quand vous n'en avez plus besoin.

Mis à jour : 2026-10-19  
Source : https://drime.cloud/fr/support/integrations-et-api/jetons-d-api

Un token d'API permet à un script ou à un outil, comme rclone, d'accéder à votre compte Drime sans votre mot de passe. Vous choisissez ce que chaque token peut faire, et vous pouvez le révoquer à tout moment.

Les tokens personnels servent à vos propres scripts, sauvegardes et outils, sur votre propre compte. Une application que d'autres utilisateurs de Drime connectent à leur compte utilise OAuth à la place, et ne doit jamais leur demander leur mot de passe : voir la [documentation de l'API Drime](https://docs.drime.cloud/authentication) (en anglais).

## Créer un token

1. En haut à droite, cliquez sur votre avatar, puis sur **Paramètres**.

2. Cliquez sur **Développeurs**.

3. Dans **Jetons d'accès API**, cliquez sur **Créer un jeton**.

   ![Paramètres, Développeurs, avec la section Jetons d'accès API et le bouton Créer un jeton](https://drime.cloud/media/01M5AFWE49NT56YR0QBXB8X5E5/439a53d9f559-web-settings-developers-tokens.png)

4. Dans **Nom du jeton**, donnez au token un nom facile à reconnaître.

   Indiquez l'outil ou l'ordinateur qui l'utilise, par exemple « rclone sur mon NAS ». Le nom doit compter de 3 à 100 caractères.

5. Sous **Autorisations**, choisissez ce que le token peut faire.

   - **Tout** : accès complet à toutes les ressources.
   - **Lecture seule** : accès en lecture seule à toutes les ressources.
   - **Restreint** : accès uniquement aux ressources que vous choisissez, chacune réglée sur **Aucun accès**, **Lues** (lecture) ou **Écriture**.

   Voir [Choisir les bonnes autorisations](#permissions).

   ![La fenêtre de création de token avec le nom du token et les onglets des autorisations](https://drime.cloud/media/01M59VYKDND34RZK3FQ6WC51B4/2311658ccbf5-web-settings-developers-token-dialog.png)

6. Cliquez sur **Créer**.

7. Cliquez sur **Copier** pour copier le token, puis sur **Terminé**.

   Le bouton affiche **Copié !** une fois le token dans votre presse-papiers.

   ![Le nouveau token affiché une seule fois, avec le bouton Copier et l'avertissement de le conserver en lieu sûr](https://drime.cloud/media/01M5AFWBMDF071MJG7WAE0SFGD/e19f990efdb1-web-settings-developers-token-shown-once.png)

> **Important**
>
> Le token n'est affiché qu'une seule fois : **Assurez-vous de conserver le jeton en lieu sûr. Une fois cette boîte de dialogue fermée, le jeton ne sera plus visible.** Rangez-le tout de suite dans un gestionnaire de mots de passe ou dans la configuration de votre outil. Si vous le perdez, supprimez-le et créez-en un nouveau.

Le token apparaît ensuite dans **Jetons d'accès API** et fonctionne aussitôt. Il n'expire pas : il fonctionne jusqu'à ce que vous le supprimiez.

## Choisir les bonnes autorisations

Ne donnez à un token que ce dont il a besoin.

| Autorisation | Ce que le token peut faire |
| --- | --- |
| **Tout** | Tout ce que votre compte peut faire par l'API. |
| **Lecture seule** | Lire chacune des ressources ci-dessous, sans rien modifier. |
| **Restreint** | Uniquement les ressources réglées sur **Lues** ou **Écriture**. Tout ce qui reste sur **Aucun accès** est refusé. |

Un token **Restreint** propose ces ressources : **Fichiers** (versions et corbeille comprises), **Dossiers**, **Partage**, **Espaces de travail**, **Vault**, **Signer**, **Tableaux blancs**, **Demandes de fichiers**, **Envoyer et suivre**, **Contacts**, **Étiquettes** et **Analyses**. **Analyses** (l'utilisation du stockage) ne peut qu'être lue : ses choix sont **Aucun accès** et **Accès**. Survolez l'icône d'aide à côté d'une ressource pour voir ce qu'elle couvre.

Seul un token **Tout** peut accéder aux paramètres du compte, de sécurité et de facturation. Les tokens **Lecture seule** et **Restreint** ne le peuvent jamais.

Les autorisations d'un token ne se modifient pas après sa création. Pour les changer, créez un nouveau token avec les bonnes autorisations, mettez à jour votre outil, puis supprimez l'ancien token.

## Utiliser le token

Envoyez le token dans le header `Authorization` de chaque requête :

```
Authorization: Bearer VOTRE_TOKEN_D_ACCES
```

Le lien **Documentation** à côté de **Jetons d'accès API** ouvre la [documentation de l'API Drime](https://docs.drime.cloud/authentication) (en anglais). Pour utiliser un token avec rclone, voir [Rclone, Drime CLI et WebDAV](https://drime.cloud/fr/support/integrations-et-api/rclone-cli-et-webdav).

## Voir et supprimer vos tokens

**Jetons d'accès API** liste les tokens que vous avez créés et ceux que les applications Drime créent pour elles-mêmes : Drime Desktop, Drime Mobile et l'extension de navigateur. Chaque ligne indique :

- le nom du token, ou l'application et sa plateforme, par exemple **Application de bureau · Windows** ;
- son autorisation, par exemple **Accès complet** ;
- sa dernière utilisation, ou **Jamais utilisé**.

Si vous n'en avez aucun, la section affiche **Vous n'avez pas encore de jetons d'accès personnels**.

Pour révoquer un token :

1. Cliquez sur **Supprimer le jeton** (l'icône de corbeille) au bout de sa ligne.

   ![La fenêtre de confirmation Supprimer le jeton ?](https://drime.cloud/media/01M5ANQT2WB3NH92E6FKT3E9Z2/f68f1113cdbe-web-settings-developers-delete-token.png)

2. Cliquez sur **Supprimer** pour confirmer.

   La fenêtre prévient : **Ce jeton sera supprimé immédiatement et définitivement. Une fois supprimé, il ne pourra plus servir à des requêtes API.** **Jeton supprimé** s'affiche, et tout outil qui utilise ce token cesse aussitôt de fonctionner.

Vous pouvez aussi déconnecter les applications Drime depuis [Voir et déconnecter vos sessions et appareils](https://drime.cloud/fr/support/compte-et-parametres/sessions-et-appareils).

## En cas de problème

Les messages de l'API sont donnés en anglais, tels que la documentation de l'API les liste.

| Ce que vous voyez | Que faire |
| --- | --- |
| **Jetons d'accès API** n'apparaît pas dans **Développeurs** | L'accès à l'API n'est pas activé pour votre compte. [Contactez l'assistance Drime](https://drime.cloud/fr/support/premiers-pas/contacter-le-support-drime). |
| Vous avez perdu le token | Il ne peut plus être affiché. Supprimez-le, puis créez-en un nouveau. |
| **Créer** affiche une erreur sous **Nom du jeton** | Le nom doit compter de 3 à 100 caractères. |
| `401` avec `Unauthenticated.` | Le token est absent, erroné ou a été supprimé. Vérifiez le header `Authorization: Bearer`, ou créez un nouveau token. |
| `403` avec `This API key is missing the required scope: files.write` (ou une autre ressource) | Le token est **Lecture seule** ou **Restreint** et n'a pas cette ressource. Créez un token avec cette ressource réglée sur **Lues** ou **Écriture** (le message la nomme), ou avec **Tout**. |
| `403` avec `This endpoint cannot be accessed with a restricted API key.` | Cette partie de l'API, comme les paramètres du compte ou de facturation, demande un token **Tout**. |
| `403` avec `This action is unauthorized.` | Votre compte lui-même n'a pas le droit de faire cette action, quel que soit le token. |

## Étapes suivantes

- [Rclone, Drime CLI et WebDAV](https://drime.cloud/fr/support/integrations-et-api/rclone-cli-et-webdav)
- [Voir et déconnecter vos sessions et appareils](https://drime.cloud/fr/support/compte-et-parametres/sessions-et-appareils)