Documentation ServicePilot SaaS



API

L'API ServicePilot vous permet de lister facilement les ressources supervisées et permet aux applications externes et aux agents ServicePilot d'interagir avec les données de ServicePilot. L'API est basée sur REST avec des réponses au format JSON.

Gestion des ressources à l'aide de l'API REST

Pour pouvoir utiliser l'API REST, une clé API est nécessaire. Obtenez une clé API et utilisez-la lorsque vous appelez l'interface REST.

Obtention d'une clé d'API ServicePilot

Ouvrez la page Clés API pour gérer les clés API pour les agents ServicePilot et l'API REST. Il est suggéré d'utiliser une clé API dédiée à l'interface REST avec les privilèges Lire, Lire & Ecrire ou Lire, Ecrire & Supprimer en fonction de l'accès requis. Si cette clé est compromise, elle peut être supprimée sans affecter la collecte des données de l'agent ServicePilot.

  1. Connectez-vous à ServicePilot, en utilisant un compte appartenant à un groupe disposant du niveau d'accès Admin.
  2. Ouvrez la configuration Configuration icon
  3. Naviguer vers ClésKeys menu item
  4. Créer et noter une clé API avec l'autorisation requise Key list

Obtenir une liste de ressources

Pour obtenir une liste de toutes les ressources, appelez la méthode REST "GET" avec une clé API disposant du droit Lire. La commande curl ci-dessous est un exemple de requête utilisant la clé API 1000000000-000000-0000-0000-0000000000000000 du serveur ServicePilot https://data.servicepilot.com.

curl -H "X-Api-Key: 10000000-0000-0000-0000-000000000000" -X GET "https://data.servicepilot.com/api/resources"

Obtenir des informations sur une ressource

Pour obtenir des informations sur une ressource particulière, appelez la méthode REST "GET" avec une clé API disposant du droit Lire. La commande curl ci-dessous est un exemple de requête utilisant la clé API 1000000000-000000-0000-0000-0000000000000000 du serveur ServicePilot https://data.servicepilot.com. Il obtiendra des informations sur la ressource internalstatistics.

curl -H "X-Api-Key: 10000000-0000-0000-0000-000000000000" -X GET "https://data.servicepilot.com/api/resources/internalstatistics"

Ajouter une ressource

Pour ajouter une nouvelle ressource, appelez la méthode REST "PUT" avec une clé API disposant du droit Ecrire. La commande curl ci-dessous est un exemple de requête utilisant la clé API 1000000000-000000-0000-0000-0000000000000000 du serveur ServicePilot https://data.servicepilot.com. Il créera une nouvelle ressource nommée dns avec les paramètres présentés.

Tous les paramètres ne sont pas nécessaires. Selon le type de ressource, la liste des réponses sera différente.

curl -H "X-Api-Key: 10000000-0000-0000-0000-000000000000" -X PUT "https://data.servicepilot.com/api/resources/dns" -d "{'package': 'appmon-dns', 'view': 'main', 'agent':'', 'agentpingsnmp':'', 'x': '150', 'y': '150', 'width': '30', 'height': '30', 'shape': 'image', 'picture': 'server.svg', 'backcolor': '#000000', 'borderwidth': '1', 'bordercolor': '#777777', 'borderstyle': 'solid', 'opacity': '100', 'backgroundcolorexist': 'true', 'html': '', 'policy': '', 'answers': {'dns_server_ip_address':'10.1.1.1','hostname_fqdn_to_resolve':'www.servicepilot.com','polling_interval':'60','timeout':'5'}}"

Pour voir une liste des paramètres obligatoires et optionnels, allez à la page détails de l'API ServicePilot.

  1. En utilisant un compte avec des privilèges administrateurs, connectez-vous à ServicePilot.
  2. Ouvrez la configuration Configuration icon
  3. Accédez à l'élément API API menu button
  4. Réglez Méthode sur PUT et sélectionnez le Package souhaité.

Les paramètres seront présentés sous forme de liste ainsi que l'exemple de requête cURL situé à droite.

Supprimer une ressource

Pour supprimer une ressource particulière, appelez la méthode REST "DELETE" à l'aide d'une clé API disposant du droit Supprimer. La commande curl ci-dessous est un exemple de requête utilisant la clé API 1000000000-000000-0000-0000-0000000000000000 du serveur ServicePilot https://data.servicepilot.com. Il supprimera la ressource internalstatistics.

curl -H "X-Api-Key: 10000000-0000-0000-0000-000000000000" -X DELETE "https://data.servicepilot.com/api/resources/internalstatistics"

Ajout de ressources à partir de l'Agent

Il est possible d'ajouter automatiquement des ressources à surveiller à partir des agents ServicePilot Windows. L'objectif étant d'automatiser l'ajout des ressources associées à un agent dès que le nouvel agent devient disponible.

Pour déterminer la syntaxe de la ligne à ajouter dans la configuration de l'Agent, allez à la page détails de l'API ServicePilot.

  1. En utilisant un compte avec des privilèges administrateurs, connectez-vous à ServicePilot.
  2. Ouvrez la configuration Configuration icon
  3. Naviguer vers API API menu button
  4. Réglez Méthode sur PUT et sélectionnez le Package souhaité.

Les paramètres seront présentés sous forme de liste ainsi que l'exemple Auto-provisioning request (Agent side) situé à droite.

Des ressources peuvent être ajoutées, une par ligne, dans la boite de dialogue Auto-provisioning de la console de configuration de l'agent ServicePilot.

Setup Console Auto-provisioning

Si une installation automatisée de l'Agent ServicePiot est effectuée, les données de provisioning-auto sont stockées sous la clé de registre suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\ServicePilot Technologies\WindowsAgent\AutoProvisioning

Commencez Maintenant