Configuration
A charging station's cached configuration keys — a fast read backed by the last successful get-configuration/change-configuration command, not a live round-trip.
2 endpoints
Reads a charging_station's cached configuration keys.
get/v1/charging-stations/{charging_station_id}/configurationRequires a bearer token
Answers immediately from the last get-configuration/
change-configuration reply rather than a live round-trip to the
charging_station. Use the command endpoints to force a fresh value or change
one.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| charging_station_id* | path | string<uuid> | ChargingStation id |
| page | query | integer<int32> | 1-indexed page number. Defaults to 1. |
| per_page | query | integer<int32> | Keys per page, capped at 100. Defaults to 20. |
Responses
| Status | Body | Description |
|---|---|---|
| 200 | ListConfigurationResponse | A page of the charging_station's cached configuration keys, alphabetical by key |
| 401 | ErrorBody | Missing, invalid, or expired bearer token |
| 403 | ErrorBody | The caller is a member of the charging_station's organization but below the required role |
| 404 | ErrorBody | No charging_station with this id exists, or the caller cannot access its environment |
Reads a 2.0.1 charging_station's cached Device Model variables.
get/v1/charging-stations/{charging_station_id}/device-modelRequires a bearer token
Answers immediately from the last completed GetBaseReport/
NotifyReport exchange rather than a live round-trip to the charging_station —
there is no command endpoint to force a fresh one yet (see
docs/architecture/ocpp-2.0.1-roadmap.md Phase 5's "still open" note).
Pass q to restrict the page (and total) to variables whose
component name, component instance, variable name, or variable
instance case-insensitively contains it.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| charging_station_id* | path | string<uuid> | ChargingStation id |
| page | query | integer<int32> | 1-indexed page number. Defaults to 1. |
| per_page | query | integer<int32> | Variables per page, capped at 100. Defaults to 20. |
| q | query | string | Free-text filter over component name, component instance, variable
name, and variable instance, matched case-insensitively as a
substring. Composes with pagination (page/per_page/total
describe the filtered set). Omitted, empty, or whitespace-only
behaves as no filter at all, same as before this parameter existed. |
Responses
| Status | Body | Description |
|---|---|---|
| 200 | ListDeviceModelResponse | A page of the charging_station's cached Device Model variables, alphabetical by component/variable/attribute |
| 401 | ErrorBody | Missing, invalid, or expired bearer token |
| 403 | ErrorBody | The caller is a member of the charging_station's organization but below the required role |
| 404 | ErrorBody | No charging_station with this id exists, or the caller cannot access its environment |