Aller au contenu principal

Notifications via Webhook

Pour garder le Core (NestJS) synchronisé avec les événements matériels en temps réel, nous utilisons un système de Webhooks (HTTP POST).

En-tête Requis pour la Sécurité : X-API-Key: <SERVER_API_KEY>

Événements Pris en Charge​

1. Défaillance Critique (CHARGER_FAULT)​

Déclenché lorsqu'un connecteur entre en état de défaillance (Faulted).

{
  "event": "CHARGER_FAULT",
  "charger_id": "EVSE-001",
  "data": {
    "connector_id": "1",
    "status": "Faulted",
    "error_code": "GroundFailure"
  },
  "ts": "2026-03-16T14:30:00Z"
}

2. Début de Transaction (TRANSACTION_STARTED)​

Déclenché lorsqu'une session est autorisée et commencée.

{
  "event": "TRANSACTION_STARTED",
  "charger_id": "EVSE-001",
  "transaction_id": "1710594800",
  "data": {
    "connector_id": "1",
    "id_tag": "UID_12345",
    "timestamp": "2026-03-16T14:30:00Z",
    "meterStart": 1500.5
  },
  "ts": "2026-03-16T14:30:00Z"
}

3. Fin de Transaction (TRANSACTION_ENDED)​

Déclenché lorsque la session est terminée sur le matériel.

{
  "event": "TRANSACTION_ENDED",
  "charger_id": "EVSE-001",
  "transaction_id": "1710594800",
  "data": {
    "connector_id": "1",
    "id_tag": "UID_12345",
    "timestamp": "2026-03-16T15:45:00Z",
    "meterStop": 2500.0
  },
  "ts": "2026-03-16T15:45:00Z"
}

4. Consommation en Temps Réel (METER_VALUE)​

Déclenché périodiquement lors d'une recharge active.

{
  "event": "METER_VALUE",
  "charger_id": "EVSE-001",
  "transaction_id": "1710594800",
  "data": {
    "connector_id": "1",
    "currentEnergyWh": 2100.2
  },
  "ts": "2026-03-16T15:00:00Z"
}