For Signal Originators¶
Overview¶
A signal originator is an entity operating an automated system that submits real-time availability data for one or more hydrogen refuelling stations (HRS) to the H2-Stations platform. The platform uses these signals to compute per-fuelling-option availability statuses, which are displayed on the public H2-Stations Map.
Signals are sent via a REST API. Each signal covers one station at one point in time and reports the operational state of each fuelling option the station provides.
For the full field reference, request/response schemas, and interactive testing, see the H2-Stations API documentation.
Getting Started¶
Becoming a signal originator requires a validation process involving the operators of the stations you intend to report on. Contact h2-stations@clean-hydrogen.europa.eu to start the onboarding process.
Organisations that want to try new features before they reach production and get involved in the development process can join the beta-testers programme by contacting h2-stations@clean-hydrogen.europa.eu.
Authentication¶
All requests require a Bearer token in the Authorization header:
Authorization: Bearer <your-token>
Tokens are issued by H2-Stations administrators as part of the onboarding process.
How Station Status Is Computed¶
The platform evaluates status per fuelling option. The following conditions are checked in order; the first one that applies sets the status for that fuelling option:
| Priority | Status | Condition |
|---|---|---|
| 1 | CLOSED | Station is outside its opening hours |
| 2 | UNKNOWN | No signal received in the last 30 minutes |
| 3 | UNAVAILABLE | The latest signal indicates the station is in maintenance |
| 4 | LIMITEDLY AVAILABLE | The latest signal indicates the station has limited availability |
| 5 | UNKNOWN | This fuelling option is absent from the latest signal |
| 6 | UNAVAILABLE | The latest signal reports this fuelling option as unavailable |
| 7 | AVAILABLE | The latest signal reports this fuelling option as available |
If none of these conditions applies, the previous status persists.
Recommendations¶
Send signals every minute, not only when the status changes. After 30 minutes without a signal, the platform sets all fuelling options to UNKNOWN regardless of their previous status.
Include every fuelling option in every signal. If a fuelling option is omitted from a signal, it is treated as condition 5 above and shown as UNKNOWN. Send all fuel types the station supports in each request, even if their status has not changed.