Aller au contenu principal
Version: 24.04

MAP API

Si vous souhaitez automatiser la création ou la maintenance de cartes standard, vous pouvez utiliser l'API de Centreon MAP.

Permissions

Avec cette API, vous pouvez créer / mettre à jour / supprimer des cartes standard. Pour pouvoir utiliser l'API, le compte que vous utilisez doit avoir l'un des privilèges suivants :

  • Un compte Centreon Admin.
  • Les droits de création de carte et de modification sur les cartes que vous souhaitez mettre à jour / supprimer.

Comment utiliser l'API de Centreon MAP

Parce que l'API de Centreon MAP n'est pas évidente à utiliser, voici un scénario pour s'authentifier, puis créer une carte et y ajouter une "shape".

S'authentifier

POST : http://{{serverURL}}:8081/centreon-map/api/beta/auth/sign-in
Headers {
Content-Type = application/json
X-Client-Version = 24.04.0
}

Body {
"login" : "admin"
"password" : "denied"
}
  • Dans le résultat, récupérez le {jwtToken}. Vous devrez l'utiliser pour tous vos appels à l'API. Les headers ressembleront à ceci :
Headers {
Content-Type = application/json
X-client-version = 24.04.0
Authorization = Bearer {jwtToken}
}

Créer une carte

POST http://{{serverURL}}:8081/centreon-map/api/beta/maps
Headers {
Content-Type = application/json
X-client-version = 24.04.0
Authorization = Bearer {jwtToken}
}

Body {
"name": "My new map created from API"
}
  • Récupérez l'identifiant de la carte {mapId} et de la vue {viewId} renvoyés.

Ouvrir la carte

GET http://{{serverURL}}:8081/centreon-map/api/beta/maps/{mapId}/views/{viewId}

Créer et attacher un élément "shape" à la carte ouverte

Dans ce scénario, l'élément "shape" est un rectangle.

PUT http://{{serverURL}}:8081/centreon-map/api/beta/maps/{mapId}/views
Body: {
"id": {viewId},
"shapes": [
{
"type": "RECTANGLE",
"graphics": {
"label": "FR - Rectangle",
"x": 120,
"y": 120,
"width": 130,
"height": 53,
"color": "#0096FF",
"thickness": 1,
"borderColor": "#F0F0F0",
"line": "SOLID"
}
}
]
}

Pour plus d'informations

Suivez ce lien pour accéder à la documentation de l'API Centreon et avoir un aperçu des fonctionnalités de l'API.