Aide de Lena › Administration

Connecter un logiciel à Lena avec une clé d’API

Créer une clé d’API dans Lena Web, ce qu’elle a le droit de faire, et appeler l’API REST de Lena.

Paramètres, onglet Clés d’API : mode d’emploi de l’en-tête api-key et liste de trois clés avec leur dernière utilisation et leurs permissions.

Clés d’API

Les clés se créent dans Lena Web, « Paramètres », « Clés d’API ». Seuls les administrateurs du compte peuvent les créer, les modifier ou les supprimer.

La valeur d’une clé n’est affichée qu’à sa création. Lena n’en garde pas de copie lisible : si vous la perdez, régénérez-la. L’ancienne valeur cesse alors aussitôt de fonctionner ; le nom, les groupes et les droits de la clé ne changent pas.

Ce qu’une clé peut faire

Chaque clé est une identité du compte, avec ses propres permissions.

  • Elle n’accède qu’aux dossiers sur lesquels elle a des droits, directement ou par ses groupes, comme un utilisateur.
  • Par défaut, elle voit les fichiers des dossiers protégés mais ne peut pas lire leur contenu. La permission « Contenu des dossiers protégés » l’y autorise.
  • Elle n’accède qu’aux rooms ajoutées sous « Salles d’échange ».
  • Ce qu’elle modifie est enregistré à son nom dans l’activité.

Appeler l’API

L’API est une API REST, à l’adresse https://api.lena.cloud/v1/.

  • Envoyez la clé dans l’en-tête HTTP api-key de chaque requête.
  • Les requêtes sur les fichiers d’un lecteur attendent aussi l’en-tête drive (identifiant du lecteur). GET /v1/drives liste les lecteurs accessibles à la clé.

Elle permet de :

  • lister les lecteurs, les dossiers et les fichiers, et retrouver un élément par son chemin ;
  • envoyer et télécharger des fichiers ;
  • créer un dossier, déplacer, renommer, dupliquer et supprimer ;
  • lire le texte extrait d’un fichier, au format Markdown ;
  • créer un lien de partage et gérer son contenu ;
  • lire le contenu d’une room et gérer ses invités.

Une question sans réponse ici ? Écrivez-nous : contact@lena.cloud