Webhook

Einrichten von Webhooks.

Mit Webhooks können Änderungen zu Ladevorgängen an externe Systeme geschickt werden. Das Einreichten der Empfänger URL geht https://connect.pumpapp.co/developer. Um die Nachrichten zu validieren befindet sich im Header X-Hub-Signature-256 jeder Nachricht eine HMAC-SHA256 Signatur der Nachricht. Der Wert des Headers ist immer sha256=THE_SIGNATURE.

Beispiel einer Webhook Nachricht.

{
  "object": "event",
  "type": "connect.charging_session.updated", // .created, .updated, .closed, .invalidated
  "timestamp": 1700491148,
  "data": {
    "object": "connect.charging_session",
    "data": {
	"id": "SESSION_ID",
	"protocol": "OCPP1.6J",
      	"started_at": 1728649601,
      	"completed_at": null,
      	"last_updated": 1728650195,
      	"status": "ACTIVE", // CLOSED, INVALID
      	"stop_reason": null,
      	"device_id": "DEVICE_ID",
      	"meter_start": 47929,
      	"meter_stop": null,
      	"energy_in_kwh": 1.033,
      	"duration_in_minutes": 7,
      	"device_connector_id": 1,
      	"auth_type": "ROAMING",
      	"roaming_protocol": "OICP2.3",
      	"roaming_partner": "DE-XXX",
      	"current_power": 6.9482,
      	"current_soc": 50,
      	"final_amount": { // Can be NULL
	    "session": 0,
	    "time": 0,
	    "energy": 0,
	    "sum": 0
	},
        "tariff": { // Can be NULL
            "id": "TARIFF_ID",
            "name": "TARIFF_NAME"
        },
        "identifier_uid_code": "RFID_UID",
        "identifier_id": "CHARGE_KEY_ID",
        "identifier_name": "CHARGE_KEY_NAME"
    }
  }
}