Eco-Movement PCPR API User Guide
Introduction
Eco-Movement PCPR API is an outbound API based on the market standard OCPI protocol. The API makes it easy for consumers to connect with Eco-Movement for retrieving public charge point data for the United Kingdom.
Note
This user guide explains only the main features of OCPI protocol (version 2.2). For more in-depth documentation, refer to the original OCPI 2.2 documentation.
Available Endpoints
The following table lists the endpoints that are available for communicating using the JSON format:
| Endpoint | Description |
|---|---|
locations | The locations endpoint retrieves a list of all locations or a specific location (using the location's id). This endpoint also supports the optional date_from and date_to parameters. See Optional Parameters for more information. |
tariffs | The tariffs endpoint displays the raw tariffs shared with Eco-Movement by the CPOs using the OCPI protocol. |
statuses | The statuses endpoint returns the statuses of all EVSEs. |
Optional Parameters
To get location related information using GET requests for a specific time period, you can use the parameters date_from and date_to. These parameters use the combined date and time format from the ISO 8601 standard. All timestamps are in UTC.
The result returned by Eco-Movement consists only the changes that have occurred during the time period set using the date_from and date_to parameters.
| Parameter | Description |
|---|---|
| date_from | Use this parameter to set the starting date and time. For example, request only the updates for the last 5 minutes. |
| date_to | Use this parameter to set the ending date and time. For example, request only the updates for the last 5 minutes. |
The following is an example request using the GET method:
<https://open-chargepoints.com/api/ocpi/cpo/2.2.1/locations/?date_from=2020-12-29T17:15:09&date_to=2020-12-29T17:20:09>
Note
These parameters are only supported for
locationsendpoint. It is unrelated tostatusesendpoint, which returns the real-time status of the EVSEs.
Note
When you receive information using GET requests, which often require many paginated requests, if one or more requests fail, retry the failed requests so you don't miss that data.
Caution
Eco-Movement strongly recommends limiting simultaneous GET requests to a maximum of 5.
Updated about 1 month ago