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}
| Info |
|---|
Pour les routes nécessitant un UUID, pour trouver simplement vos UUID, vous pouvez utiliser cette page pour trouver simplement vos UUIDpage ( TIPS - Récupérer l'UUID d'un élément ( Cluster / Hôte / Check ) ) . |
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:
| Code Block |
|---|
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:
| Code Block |
|---|
http://192.168.1.59:50100/api/v1/host/408cd29ad37611e8810e0800277b7e16?token=ak5zv6t5s25r6g4 |
Chaque appel à l'API renvoie une réponse au format JSON.
| Info | ||
|---|---|---|
| ||
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. |
...