Pular para o conteúdo principal

Notificações via Webhook

Para manter o Core (NestJS) sincronizado com os eventos de hardware em tempo real, utilizamos um sistema de Webhooks (HTTP POST).

Header Requerido para Segurança: X-API-Key: <SERVER_API_KEY>

Eventos Suportados​

1. Falha Crítica (CHARGER_FAULT)​

Disparado quando um conector entra em estado de falha (Faulted).

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

2. Início de Transação (TRANSACTION_STARTED)​

Disparado quando uma sessão é autorizada e iniciada.

{
    "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. Fim de Transação (TRANSACTION_ENDED)​

Disparado quando a sessão é encerrada no hardware.

{
    "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. Consumo em Tempo Real (METER_VALUE)​

Disparado periodicamente durante uma recarga ativa.

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