L'API externe permet à vos outils (SIEM, CMDB, reporting interne, scripts) de lire les données de votre parc identifié dans Cybernetics. Elle est réservée aux clients Enterprise, et sa documentation technique vous est transmise sur demande.
🔑 PRÉREQUIS · Plan Enterprise · Rôle Administrateur · Chemin Paramètres > API
Spécification complète, transmise aux clients Enterprise sur simple demande.
Ce que permet l'API
L'API est en lecture seule : elle ne crée, ne modifie ni ne supprime aucune donnée. Elle donne accès aux mêmes informations que Mon parc :
appareils : postes, serveurs, mobiles et équipements réseau, avec leurs correctifs non installés ;
comptes utilisateurs ;
groupes ;
applications.
Vous pouvez lire la vue consolidée de votre parc, ou les seules données d'un connecteur (par exemple Microsoft Entra ID). Seules les ressources identifiées sont renvoyées : celles qui attendent encore dans Identifications n'apparaissent pas.
Obtenir la documentation
La spécification de l'API (adresses, paramètres, formats de réponse, pagination et limites de débit) n'est pas publique. Pour la recevoir, contactez-nous depuis le Messenger ou la page Nous contacter, en indiquant le nom de votre entreprise. Nous la transmettons aux clients Enterprise.
ℹ Bon à savoir
Vous n'êtes pas client Enterprise ? La clé API externe n'est pas disponible dans votre plan. Voir Plans et abonnement.
Générer vos identifiants
Ouvrez Paramètres > API.
Relevez le Client ID : c'est l'identifiant de votre entreprise.
Dans le champ Clé API Externe, cliquez sur Générer. Copiez la clé : elle ne sera plus affichée ensuite.
Vos outils échangent le Client ID et la clé contre un jeton d'accès temporaire, à envoyer avec chaque requête. Le détail figure dans la documentation.
⚠ Attention
Régénérer la clé invalide immédiatement l'ancienne : tous les outils qui l'utilisent perdent l'accès jusqu'à ce que vous leur donniez la nouvelle.
✓ Astuce
La clé API externe s'affiche dans la section Agent de la page API, à côté de la clé API Agent. Ce sont deux clés distinctes : ne confondez pas l'une avec l'autre.
Bonnes pratiques
Traitez la clé comme un mot de passe : conservez-la dans un coffre de secrets, jamais dans le code source, une URL ou un fichier partagé.
Réservez-la à un seul outil ou à une seule équipe, et régénérez-la au départ d'une personne qui la connaissait.
L'API applique des limites de débit : au-delà, elle répond par une erreur 429. Mettez les réponses en cache et espacez les appels.
Articles liés
Une question ? Nous contacter.