BeeBee
API

API'Culture

L’API permet aux outils de monitoring et aux applications du système d’information d’interagir facilement avec Bee. Elle offre de nombreuses fonctionnalités pour consulter les informations et agir directement sur les alertes. Il est ainsi possible de piloter précisément leur traitement, notamment en activant des downtimes, en régulant le flux d’alertes ou en déclenchant des actions adaptées au contexte. Tous les appels disponibles sont référencés et documentés via Swagger, afin de faciliter leur intégration et leur utilisation.

Création d'une alerte simple
POST /api/alert/create
DESCRIPTION

Créer une alerte simple dans Bee.

PARAMÈTRES
{
  "itsmRecipient": "ITOP",
  "provider": "CENTREON",
  "title": "Hornet est DOWN",
  "description": "server hornet - connexion KO",
  "source": "SRV_HORNET",
  "status": "DOWN",
  "criticality": 1,
  "urgency": 1
}
RÉPONSE

Code retour 200

Liste des alertes
GET /api/alert/list
DESCRIPTION

Liste les alertes.

PARAMÈTRES

Aucun paramètre.

RÉSULTAT
[
  {
    "id": 999,
    "incidentNumber": "<a href=\<url outil itsm>\">num ticket</a>",
    "ticketStatus": null,
    "provider": "CENTREON",
    "description": "message d'alerte",
    "itsmRecipient": "ITOP",
    "source": "MyServer",
    "alarmCode": "ALCENT20000",
    "priority": 3,
    "creationDate": "2025-09-06T22:04:35.508483",
    "providerDetails": "{\"idsolapp\": \"My Appli\", \"addresse ip\": \"127.0.0.1\"}",
    "status": "WARNING",
    "criticality": 1,
    "urgency": 3
  },
  :
  :
]
Opérateur d’astreinte
POST /api/notification/who-is-on-duty
DESCRIPTION

Connaître l’opérateur d’astreinte d’un calendrier pour une date donnée.

PARAMÈTRES
{
  "date": "2025-09-10 20:28:00",
  "calendarId": 1
}
RÉPONSE
[
  {
    "id": 1,
    "firstname": "Didier",
    "lastname": "BUMBLEBEE",
    "trigram": "DBU",
    "fullName": "Didier BUMBLEBEE (DBU)",
    "email": "name@email.com",
    "phone": null,
    "pushover": "xxx",
    "teams": null,
    "colorCode": "#ffd500",
    "groups": [
      {
        "id": 1,
        "name": "ASTREINTE_SYSTEME",
        "sqlRule": "provider_details->>'Notification'='ASTREINTE_SYSTEME'"
      }
    ],
    "calendars": [
      {
        "id": 2,
        "name": "P1_JOUR",
        "description": "P1 en journée",
        "escalation": false
      },
      {
        "id": 1,
        "name": "SYSTEME",
        "description": "Calendrier Système",
        "escalation": false
      }
    ]
  }
]
RETOUR À L’ACCUEIL