Skip to content

List completed charging sessions for a charger in a time range#47

Merged
martijnversluis merged 1 commit into
mainfrom
archived-sessions-endpoint
Jul 17, 2026
Merged

List completed charging sessions for a charger in a time range#47
martijnversluis merged 1 commit into
mainfrom
archived-sessions-endpoint

Conversation

@martijnversluis

Copy link
Copy Markdown
Contributor

Backfillen van cpo_transaction_identifier op historische Zaptec-sessies werkte goed genoeg dat we hetzelfde nu voor Easee willen doen. Deze PR voegt de client-kant toe: één call naar /api/sessions/charger/{id}/sessions/{from}/{to} geeft in één response alle voltooide (en niet-voltooide) sessies van een lader over een periode terug.

Nieuw:

  • Easee::Client#sessions(charger_id, from:, to:) — normaliseert de from/to naar UTC (zaptec-endpoint gaf HTTP 500 bij een niet-UTC-offset; we nemen hier hetzelfde geen risico) en yieldt Easee::ArchivedSession value objects.
  • Easee::ArchivedSession — leest de velden die de backfill nodig heeft (id, charger_id, car_connected/car_disconnected, energy_kwh, complete?) plus wat cheap-to-expose extra's (energie-transferperiode, duur, auth-token/user).

Rate limit is 10 requests / 60 min op dit endpoint volgens de docs. Callers moeten daar zelf rekening mee houden; hier houden we ons buiten.

Backfilling Zaptec's cpo_transaction_identifier on historical sessions
worked so well that we want the same for Easee. The Sessions API
returns every completed session per charger over an arbitrary date
range in a single response, and this exposes it as ArchivedSession
value objects so the caller does not need to touch the raw payload.
@martijnversluis
martijnversluis merged commit e7c7c76 into main Jul 17, 2026
1 check passed
@martijnversluis
martijnversluis deleted the archived-sessions-endpoint branch July 17, 2026 19:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant