| Scroll Ignore | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Concept
Cette API permet l'édition de météo de service. Cette édition se fait à l'aide du format JSON ( voir la
pagepage Édition JSON - Météo ).
Cette API est accessible uniquement aux administrateurs Shinken
uniquement pour l'instant.
Seule la structure de la vue peut être manipulée. Les données de supervision ne sont pas retournées.
Les routes ( appels REST )
Les routes suivantes sont mises à disposition par l'API.
| Panel | |
|---|---|
|
Sécurité
L'API est requérable en HTTP / HTTPS ( via un certificat TLS 1.1/ 1.2 ) en fonction du paramétrage du module ( voir la page Configuration du module WebUI ).
Authentification
Le contrôle d'accès à l'API du module se fait par login/mot-de-passe.
| Warning |
|---|
La WebUI doit avoir au moins un module d'authentification par login/mot-de-passe dans la chaîne d'authentification ( par exemple Cfg_password ou webui-module-authentication-LDAP ). |
Exemple avec curl :
| Code Block | ||||
|---|---|---|---|---|
| ||||
API_USERNAME="admin"
API_PASSWORD="password"
curl -s -S -u "${API_USERNAME}:${API_PASSWORD}" \
"http://webui:7767/external-api/service-weather/v1/list" |
La plupart des outils fournissent une option pour envoyer les identifiants dans la requête ( ici -u pour curl ).
Si aucune option n'est disponible, les identifiants devront est présent dans le header HTTP de la requête sous la forme "utilisateur:mot-de-passe" encodé en base64
- { Authorization: Basic base64("USER:PASSWORD") }
Exemple :
| Code Block | ||||
|---|---|---|---|---|
| ||||
API_USERNAME="admin"
API_PASSWORD="password"
# Obtenir la représentation en base64
API_TOKEN="$(echo -n "${API_USERNAME}:${API_PASSWORD}" | base64)"
curl -s -S -H "Authorization: Basic ${API_TOKEN}" \
"http://webui:7767/external-api/service-weather/v1/list" |