Créer un token 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 (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.

   

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.

   

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

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 (en anglais). Pour utiliser un token avec rclone, voir Rclone, Drime 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.

   

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.

#En cas de problème

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

#Étapes suivantes

• Rclone, Drime CLI et WebDAV

• Voir et déconnecter vos sessions et appareils