Intégrations API et agents IA

Une clé API permet à vos propres logiciels – un système RH, un script de reporting ou un agent IA – de travailler avec les données de votre organisation sans qu’une personne se connecte. La clé appartient à l’organisation, pas à vous : elle continue donc de fonctionner si vous changez de poste, et vous pouvez la révoquer en un clic.

Qui peut le faire ?

Réservé aux administrateurs de l’organisation. Ouvrez Paramètres de l’organisation → Intégrations. Les développeurs créent leurs clés dans Applications → Intégrations.

Voir vos clés

La carte Clés API liste toutes les clés de l’organisation avec leur Portée, leurs Rôles, leur date d’expiration, leur Dernière utilisation et leur Statut (Actif, Révoquée ou Expirée). Sous le nom, vous ne voyez que le début de la clé, jamais sa valeur complète.

Carte Clés API avec des clés actives et révoquées

Créer une clé

1Ouvrez Paramètres de l’organisation → Intégrations.
2Cliquez sur Créer une clé.
3Dans Nom, donnez-lui le nom de l’outil qui l’utilisera – c’est ce nom que vous verrez dans le journal des requêtes.
4Dans Rôles, choisissez ce que la clé obtient : Administrateur, Analyste ou Administrateur des appareils. Une clé ne peut jamais faire plus que vous : vous ne voyez donc que les rôles que vous avez vous-même.
5Dans Portée, choisissez Lecture seule ou Lecture et écriture.
6Dans Validité, choisissez 30, 90 ou 365 jours.
7Cliquez sur Créer la clé.

Nous affichons la clé une seule fois, juste après sa création. Copiez-la dans votre gestionnaire de mots de passe ou votre coffre à secrets avant de fermer la fenêtre. Si vous la perdez, renouvelez la clé et utilisez la nouvelle.

Traitez la clé comme un mot de passe

Toute personne qui la détient peut lire les données de votre organisation dans la limite des rôles que vous avez accordés. Ne la collez jamais dans une conversation, un ticket ou un dépôt public.

À quoi ressemble la clé

Chaque clé commence par sk_live_, par exemple sk_live_7Hq2mZk1_…. Le tableau de bord ne stocke que son empreinte (hash) et le préfixe visible : c’est pourquoi nous ne pouvons plus vous montrer la clé complète.

Envoyez-la dans l’en-tête Authorization :

Authorization: Bearer sk_live_7Hq2mZk1_…

Rôles et portée

Les Rôles déterminent quelles données la clé voit – exactement les mêmes règles que pour une personne ayant ce rôle.
La Portée détermine ce qu’elle peut faire : une clé en lecture seule est refusée avec 403 pour toute écriture.
La clé ne fonctionne que dans l’organisation où elle a été créée. Elle n’a aucun accès au tableau de bord (api/web).

Expiration et renouvellement

Une clé cesse de fonctionner dès qu’elle expire. Les deux actions ci-dessous se trouvent dans le menu en fin de ligne d’une clé active.

Renouveler vous donne une nouvelle valeur de clé tandis que l’ancienne continue de fonctionner pendant 24 heures – de quoi redéployer votre outil sans interruption.
Révoquer désactive une clé immédiatement ; chaque appel avec cette clé est refusé en moins d’une minute. Cette action est irréversible.

Menu de la ligne d’une clé API avec Renouveler et Révoquer

Limites

10 clés actives par organisation et par contexte.
120 requêtes par minute par clé. Au-delà, l’API répond 429 avec un en-tête Retry-After.

Le journal des requêtes

La carte Journal des requêtes sur la même page liste chaque appel effectué avec une clé de cette organisation : la clé, la méthode et le chemin, le statut de la réponse, la durée et s’il est passé par REST ou MCP. Filtrez-le par Clé ou par Statut lorsque vous déboguez une intégration – un 429 signifie que la clé a atteint la limite de requêtes. Les entrées sont conservées 90 jours.

Journal des requêtes avec les filtres par clé et par statut

La référence de l’API

La liste complète des points de terminaison et le format des requêtes et des réponses se trouvent dans la référence de l’API : api.skillsive.com/core/docs/v1. Le bouton Documentation de l'API de la page Intégrations ouvre la même page.

Connecter un agent IA (MCP)

La même clé vous authentifie auprès du serveur MCP de Skillsive à l’adresse https://api.skillsive.com/core/mcp, qui expose l’API sous forme d’outils qu’un agent peut appeler directement.

Claude Code – une seule commande dans votre terminal :

claude mcp add --transport http skillsive https://api.skillsive.com/core/mcp --header "Authorization: Bearer sk_live_…"

Cursor – ajoutez le serveur à ~/.cursor/mcp.json (ou à .cursor/mcp.json dans le projet) :

{
	"mcpServers": {
		"skillsive": {
			"type": "http",
			"url": "https://api.skillsive.com/core/mcp",
			"headers": { "Authorization": "Bearer sk_live_…" }
		}
	}
}

Connecteurs Claude.ai et ChatGPT

Les connecteurs des applications web Claude et ChatGPT exigent une connexion OAuth, que Skillsive ne prend pas encore en charge. Les agents qui s’authentifient par un en-tête – Claude Code, Cursor et vos propres agents – fonctionnent dès aujourd’hui.

FAQ

J’ai fermé la fenêtre avant de copier la clé. Puis-je la revoir ?

Non – nous ne stockons que son empreinte. Ouvrez le menu de la clé, cliquez sur Renouveler et copiez la nouvelle valeur.

Quel rôle donner à un outil RH ou de reporting ?

Administrateur. La lecture des apprenants, des réalisations de cours et des certificats nécessite une clé Administrateur – une clé Analyste ne peut lire que les informations propres à l’organisation. Pour que la clé reste inoffensive, donnez-lui la portée Lecture seule : elle peut lire les données, mais jamais les modifier.

Une clé cesse-t-elle de fonctionner quand la personne qui l’a créée part ?

Non. La clé appartient à l’organisation. Révoquez-la vous-même lorsque l’outil n’est plus utilisé.