User Guide

This page provides you the details instruction on interacting with E.ON One APIs.

Getting Access

In your profile page, there is a field containing your current access token. In order to consume the E.ON One APIs, please contact us to request client credentials.

Requesting Access Token

The Client Credentials grant is used to request an access token for machine-to-machine communication. The following curl request shows how to retrieve a new access token to our APIs.

Request

curl --request POST \
  --url https://login.onetp.eon.com/oauth/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data client_id=<< application client_id>> \
  --data 'client_secret=<< application client_secret>>' \
  --data grant_type=client_credentials \
  --data audience=public 

Hint: The audience is mandatory and should be set to public unless specified otherwise when receiving your client credentials.

Response

{
    "access_token": "<< access token >>",
    "expires_in": 86400,
    "token_type": "Bearer"
}

For each product, the SwaggerUI is provided with an option to authenticate and try out a request in place. If additional permissions are required, please contact us for a trial.

Message Format

Content-Type

Unless otherwise specified in the product's API documentation, our APIs accept and respond in JSON format.

Error Message

Our APIs respond with the same JSON schema in case of an error. Please see the Troubleshooting page for further details.

Date & Time

Our APIs accept and respond with time values conforming to the ISO 8601 format.