Événements d'erreur

Contexte

L'API Événements d'erreur donne accès aux mêmes événements d'erreur que ceux disponibles dans le tableau de bord ChargePilot, dans la section Événements d'erreur. Un événement d'erreur est déclenché lorsqu'un contrôleur local passe hors ligne, ou lorsqu'une borne de recharge ou l'un de ses connecteurs signale une défaillance. Il est clôturé dès que l'équipement est rétabli.

Chaque événement est identifié par un event_id. Utilisez l'endpoint de liste pour trouver les événements d'un site, puis l'endpoint de détail pour récupérer l'enregistrement complet d'un événement.

Endpoints disponibles

• GET /error-events/site/{id} - Récupérer les événements d'erreur d'un site spécifique
• GET /error-events/site/{id}/{event_id} - Récupérer un événement d'erreur unique

GET /error-events/site/{id}

Renvoie une liste paginée d'événements d'erreur pour le site indiqué, filtrée par période et éventuellement triable et consultable par recherche.

Paramètres de chemin

Paramètre	Type	Requis	Description
id	string	Oui	L'ID du site pour lequel récupérer les événements d'erreur

Paramètres de requête

Paramètre	Type	Requis	Description
start_date	string (ISO 8601)	Oui	Début de la période
end_date	string (ISO 8601)	Oui	Fin de la période
search_text	string	Non	Recherche en texte libre sur l'ID d'appareil, le message d'erreur et le nom du point de charge (max. 100 caractères)
sort_field	string	Non	Champ de tri des résultats — voir Champs de tri
sort_order	asc | desc	Non	Ordre de tri des résultats (desc par défaut)
take	number	Non	Nombre d'enregistrements à renvoyer (max. 200)
skip	number	Non	Nombre d'enregistrements à ignorer, pour la pagination

Réponse

{
  "events": [
    {
      "event_id": "0f1c1f2e-9c4a-4a1f-8a1e-2f0f9b0f3c11",
      "error_status": "active",
      "device_id": "a1b2c3d4",
      "charging_point_name": "Charging Point 1",
      "error_message": "GroundFailure",
      "error_date": "2026-05-15T10:00:00.000Z",
      "automatic_recovery_status": "initiated",
      "site_name": "Depot North",
      "case_type": "connector_error"
    }
  ],
  "records_count": 42
}

Champ	Type	Description
events	array	Liste des objets événement d'erreur
records_count	number	Nombre total d'enregistrements correspondants

GET /error-events/site/{id}/{event_id}

Renvoie l'enregistrement complet d'un événement d'erreur, y compris la date de résolution et les éventuelles informations d'erreur propres au fabricant remontées par la borne de recharge.

Répond 404 si aucun événement d'erreur ne correspond à l'event_id fourni.

Paramètres de chemin

Paramètre	Type	Requis	Description
id	string	Oui	L'ID du site auquel appartient l'événement d'erreur
event_id	string	Oui	L'ID de l'événement d'erreur, tel que renvoyé dans event_id par l'endpoint de liste

Réponse

{
  "site_name": "Depot North",
  "controller_id": "a1b2c3d4",
  "charger_id": "charger-1",
  "charging_point_name": "Charging Point 1",
  "error_status": "recovered",
  "error_message": "GroundFailure",
  "error_occurred": "2026-05-15T10:00:00.000Z",
  "error_resolved": "2026-05-15T11:00:00.000Z",
  "automatic_recovery_status": "initiated",
  "automatic_recovery_time": "2026-05-15T10:30:00.000Z",
  "case_type": "connector_error",
  "vendor_error_code": null,
  "vendor_info": null
}

Données

Événement d'erreur

Chaque entrée du tableau events contient les champs suivants :

Champ	Type	Description
event_id	string	Identifiant unique de l'événement d'erreur
error_status	string	Indique si l'erreur est toujours en cours — voir Statut d'erreur
device_id	string	ID du contrôleur local ou de la borne de recharge ayant signalé l'erreur
charging_point_name	string	Nom d'affichage du point de charge concerné
error_message	string	L'erreur signalée, généralement un code d'erreur OCPP (par ex. GroundFailure, Offline)
error_date	string (ISO 8601)	Date à laquelle l'erreur est survenue
automatic_recovery_status	string	Voir Statut de rétablissement automatique
site_name	string	Nom d'affichage du site
case_type	string	Type d'équipement défaillant — voir Types de défaillance

Détail d'un événement d'erreur

L'endpoint pour un événement unique renvoie les champs suivants :

Champ	Type	Description
site_name	string	Nom d'affichage du site
controller_id	string	ID du contrôleur local gérant l'équipement concerné
charger_id	string	ID de la borne de recharge concernée
charging_point_name	string	Nom d'affichage du point de charge concerné
error_status	string	Indique si l'erreur est toujours en cours — voir Statut d'erreur
error_message	string	L'erreur signalée, généralement un code d'erreur OCPP
error_occurred	string (ISO 8601)	Date à laquelle l'erreur est survenue
error_resolved	string (ISO 8601)	Date de résolution, ou null tant que l'erreur est active
automatic_recovery_status	string	Voir Statut de rétablissement automatique
automatic_recovery_time	string (ISO 8601)	Date de la dernière tentative de rétablissement automatique. N'indique pas si elle a réussi
case_type	string	Type d'équipement défaillant — voir Types de défaillance
vendor_error_code	string	Code d'erreur propre au fabricant remonté par la borne de recharge, lorsqu'il est disponible
vendor_info	string	Informations d'erreur supplémentaires propres au fabricant, lorsqu'elles sont disponibles

Tout champ peut valoir null lorsque la donnée sous-jacente n'est pas disponible.

Statut d'erreur

Valeur	Description
active	L'erreur est en cours et l'équipement n'est pas rétabli
recovered	L'équipement est rétabli et l'erreur est clôturée

Types de défaillance

Valeur	Description
controller_error	Le contrôleur local est passé hors ligne
charger_error	La borne de recharge a signalé une erreur ou une défaillance
connector_error	Un connecteur de la borne de recharge a signalé une erreur ou une défaillance

Statut de rétablissement automatique

ChargePilot tente de résoudre certaines erreurs automatiquement, par exemple en redémarrant la borne de recharge concernée.

Valeur	Description
initiated	Un rétablissement automatique a été déclenché pour cette erreur
not_initiated	Aucun rétablissement automatique n'a été déclenché — soit il ne s'applique pas à cette erreur, soit il est encore en attente, soit une tentative précédente ne s'est pas achevée

Champs de tri

Le paramètre de requête sort_field accepte les valeurs suivantes :

Valeur	Description
error_date	Trier par date de survenue de l'erreur
error_status	Trier par statut d'erreur
device_id	Trier par ID d'appareil
charging_point_name	Trier par nom du point de charge
error_message	Trier par message d'erreur
case_type	Trier par type de défaillance
site_name	Trier par nom de site
automatic_recovery_status	Trier par statut de rétablissement automatique