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.

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-keyde chaque requête. - Les requêtes sur les fichiers d’un lecteur attendent aussi l’en-tête
drive(identifiant du lecteur).GET /v1/drivesliste 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