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}
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.
Authentification
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.
Remarque
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.