Calling the APIs

You can call the APIs using an API client.

Using an API Client

Use an API client of your choice to call the SAP E-Mobility APIs using the endpoint URL.

The URL usually consists of the following parts:

<base URL>/<market role>/<protocol>/<service name>/<version>/<endpoint>

Please see the OCPI service section for the OCPI URL syntax.

The URL parts are as follows:

Base URL: The attribute url as shown in the service key.
Market Role: The market role accronym, emsp (e-Mobility Service Provider) or cpo (Charging Point Operator), according to the service.
Protocol: The API protocol, rest or odata.
Service Name: The name of the service as specified in this guide.
Version: The version of the service.
Endpoint: You can find the endpoint part of the URL in the operation descriptions in this guide.

Note

The endpoint syntax differs according to the procotol. Lower camel case is used for REST endpoints, upper camel case is used for OData endpoints.

Example

OData: https://api.eu10.e-mobility.cloud.sap/api/cpo/odata/chargingStation/v1/Evses

REST: https://api.eu10.e-mobility.cloud.sap/api/ocpi/cpo/2.2.1/cdrs

In the authorization header of your API call, use the token that you retrieved in the previous step as the bearer token.

Example Header Keys for POST Call
Key	Value
Content Type	application/json
Authorization	Bearer `<token>` (replace `<token>` with your own token)

The APIs you can consume are listed here: SAP E-Mobility APIs