Voici la liste des routes disponibles dans ce module :
V1 - ( READ ) /api/v1/all-monitored-elements
V1 - ( READ ) /api/v1/host/{uuid}
V1 - ( READ ) /api/v1/check-on-host/{uuid}
V1 - ( READ ) /api/v1/cluster/{uuid}
V1 - ( READ ) /api/v1/check-on-cluster/{uuid}
Pour les routes nécessitant un UUID, vous pouvez utiliser cette page pour trouver simplement vos UUID. |
Les routes suivantes sont mises à disposition par l'API. Chaque appel doit contenir dans ses paramètres le token d'identification décrit dans la section précédente.
L'API du module broker-module-livedata est accessible à l'adresse suivante:
http://<ip-broker>:<port-module>/ |
Les appels effectués à l'API demandent l'utilisation d'un token d'identification. Ce token est spécifié dans le fichier de configuration du module (/etc/shinken/modules/broker-module-livedata.cfg).
Il est fortement recommandé de changer ce token.
Ce token doit être ajouté en paramètre à chaque requête sous peine de recevoir une erreur 401 de la part de l'API.
Par exemple:
http://192.168.1.59:50100/api/v1/host/408cd29ad37611e8810e0800277b7e16?token=ak5zv6t5s25r6g4 |
Chaque appel à l'API renvoie une réponse au format JSON.
Avec le module configuré en HTTP, une simple écoute du réseau permet de trouver le token. Il est fortement recommandé de passer en HTTPS afin d'éviter une interception du token. |