Clés API
Créez et révoquez les clés qui permettent à vos propres outils de lire les données de Tera.
Où se trouvent vos clés
Une clé permet à vos propres outils, ou à un assistant d'IA (voir Connecter votre assistant d'IA), de lire les données de Tera sans qu'une personne se connecte, et ce qu'elle lit est imputé à l'offre de votre entreprise. Chaque offre inclut l'API et MCP, et vos clés se trouvent sur la page API et MCP :
- Un compte pour une seule personne : l'onglet API et MCP de votre page Compte.
- L'administrateur d'une équipe : API et MCP dans Administration de l'organisation, avec toutes les clés de l'espace de travail et leur auteur (voir Qui peut inviter pour y accéder).
- Un membre d'une équipe : l'onglet API et MCP de votre page Compte, avec vos propres clés. Votre administrateur peut les voir et les révoquer, et elles cessent de fonctionner si vous quittez l'espace de travail.
- Une entreprise dont le compte ne donne accès qu'à l'API se connecte à la console API, qui présente la même page.
Le tableau des clés fonctionne partout de la même façon. La liste complète des requêtes qu'une clé peut envoyer figure dans la référence de l'API sur notre site.
Activer l'accès à l'API
Avec les offres Free, Pro et Team, la première fois que la page API et MCP s'ouvre, un administrateur accepte les conditions de l'API pour l'entreprise : cochez J'accepte les conditions d'utilisation de l'API pour mon entreprise, puis choisissez Obtenir l'accès à l'API. Utilisez Lire les conditions d'utilisation de l'API si vous souhaitez d'abord les consulter. Une fois l'accès activé, la page affiche le Solde de crédits, les Crédits gratuits restants (renouvelés chaque mois), les Lignes lues ce mois-ci et les Requêtes des dernières 24 heures, avec vos clés sous Clés API. D'ici là, les membres d'une équipe voient que leur administrateur n'a pas encore activé l'accès à l'API. Une licence inclut l'accès à l'API : la page s'ouvre alors directement sur les clés. Si la page indique L'accès à l'API n'est pas encore ouvert., il n'y a rien à faire tant qu'il n'est pas ouvert.
Créer une clé
- Ouvrez la page API et MCP et choisissez Créer une clé.
- Donnez-lui un Nom de la clé, par exemple le système qui l'utilisera. Ce nom est destiné à votre usage, pour distinguer vos clés.
- Choisissez sa durée de validité sous Expire après : 30 jours, 90 jours, 1 an (par défaut) ou Jamais.
- Si votre offre inclut les e-mails professionnels (Pro, Team, ou une licence qui inclut les coordonnées), cochez Peut afficher les adresses e-mail pour que cette clé puisse rechercher l'e-mail professionnel d'une personne, dans la limite des affichages autorisés à votre équipe.
- Saisissez votre mot de passe sous Confirmez votre mot de passe. Une clé fonctionne sans votre mot de passe ni votre code à deux facteurs : nous vérifions donc d'abord que c'est bien vous. Si vous vous connectez via le fournisseur d'identité de votre entreprise et n'avez pas de mot de passe, laissez le champ vide.
- Choisissez Créer.
La nouvelle clé ne s'affiche qu'une fois, sous Votre nouvelle clé. Choisissez Copier, enregistrez-la là où votre outil peut la lire, puis choisissez Terminé. Nous ne conservons qu'une empreinte de la clé : elle ne peut donc plus être affichée. Si vous la perdez, révoquez-la et créez-en une autre.
Garder une clé secrète
- Traitez une clé comme un mot de passe : quiconque la détient peut lire les données de Tera au nom de votre espace de travail, et rien d'autre ne demande votre mot de passe ni votre code à deux facteurs.
- Ne la placez pas dans des documents partagés, des messages de messagerie, des pages web ou du code que d'autres peuvent lire ; mettez-la dans les paramètres secrets de votre outil.
- Créez une clé par système, à son nom, pour pouvoir en révoquer une sans arrêter les autres.
- Choisissez la durée de validité la plus courte qui convient à la tâche.
- Si une clé a pu fuiter, révoquez-la immédiatement.
Voir ce que fait une clé
Le tableau liste, pour chaque clé, son Nom, le début public de la Clé, son Accès, sa date de Création, sa Dernière utilisation (Jamais si elle n'a pas servi) et son Statut : Active, Expirée ou Révoquée. Recherchez par nom ou par clé au-dessus du tableau.
Au-dessus du tableau, la page API et MCP affiche les Clés actives, les Crédits utilisés sur la période de facturation, ainsi que les Requêtes et les Enregistrements fournis sur les dernières 24 heures. Pour une clé, ouvrez son menu Actions et choisissez Voir la consommation : un récapitulatif des requêtes, des enregistrements fournis et des crédits, puis chaque appel avec sa Route, son Statut, ses Enregistrements, ses Crédits et sa Date et heure. Une clé qui n'a pas servi affiche Cette clé n'a pas encore été utilisée.
Révoquer une clé
Ouvrez le menu Actions de la clé, choisissez Révoquer et confirmez sous Révoquer cette clé ? Tout ce qui utilise la clé cesse immédiatement de fonctionner, et cette action est irréversible. Une clé révoquée reste dans le tableau avec le statut Révoquée ; pour continuer, créez une nouvelle clé et donnez-la à votre outil.