Local authorization list
The per-charging station allow-list a charging station authorizes against while offline (OCPP 1.6 §3.5.2). Curating a list selects from the id-token registry and takes Admin; pushing one to a charging station takes Owner and is recorded, because it puts token values on a wire — see docs/adr/0008-pushing-an-authorization-list-is-not-a-reveal.md. The push itself lives under Commands.
2 endpoints
Reads a charging_station's local authorization list.
get/v1/charging-stations/{charging_station_id}/local-auth-listRequires a bearer token
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| charging_station_id* | path | string<uuid> | ChargingStation id |
Responses
| Status | Body | Description |
|---|---|---|
| 200 | LocalAuthListView | The charging_station's list |
| 401 | ErrorBody | Missing, invalid, or expired bearer token |
| 403 | ErrorBody | Below the required role |
| 404 | ErrorBody | No such charging_station, or it has no list yet |
Replaces a charging_station's local authorization list membership, creating the list if it has none.
put/v1/charging-stations/{charging_station_id}/local-auth-listRequires a bearer token
Does not contact the charging_station and does not move the list's version — see this module's doc.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| charging_station_id* | path | string<uuid> | ChargingStation id |
Request bodyReplaceListRequest
| Field | Type | Description |
|---|---|---|
| entries* | array<EntryRequest> | — |
Responses
| Status | Body | Description |
|---|---|---|
| 200 | LocalAuthListView | The updated list |
| 400 | ErrorBody | A duplicate or out-of-environment token |
| 401 | ErrorBody | Missing, invalid, or expired bearer token |
| 403 | ErrorBody | Below the required role |
| 404 | ErrorBody | No such charging_station |