Authentication

The API accepts 2 different authentication methods:

OAuth2

Retrieve an Access Token with the OAuth 2.0 flows described below before accessing the API. Once you have an access token, send it in the Authorization HTTP header to authenticate with the API.

Flow type authorizationCode
Authorization URL https://id.pace.cloud/auth/realms/pace/protocol/openid-connect/auth
Token URL https://id.pace.cloud/auth/realms/pace/protocol/openid-connect/token
Refresh URL https://id.pace.cloud/auth/realms/pace/protocol/openid-connect/token
Scopes
  • poi:apps:read: Get/search for an app
  • poi:pois:read: Get/search for pois
  • poi:tiles:read: Get/search for tiles
  • poi:apps:create: Create an app
  • poi:apps:delete: Delete an app
  • poi:apps:update: Change an app
  • poi:events:read: Get/search for events
  • poi:pois:update: Update a poi
  • poi:sources:read: Get/search for sources
  • poi:policies:read: Get/search for policies
  • poi:sources:create: Create a source
  • poi:sources:delete: Delete a source
  • poi:sources:update: Update a source
  • poi:policies:create: Create a policy
  • poi:gas-stations:read: Get/search for gas stations
  • poi:subscriptions:read: List all subscriptions
  • poi:pois.references:read: Enabled additional reference data on the poi
  • poi:subscriptions:create: Create a subscription
  • poi:subscriptions:delete: Delete a subscription
  • poi:gas-stations.references:read: Enabled additional reference data on the gas station
  • poi:gas-stations.references:update: Write additional reference data on the gas station

Oidc (openIdConnect)

OpenID Connect is a simple identity layer on top of the OAuth 2.0 protocol. It enables Applications to verify the identity of End-Users based on the authentication performed by an Authorization Server.

The OpenID Connect URL for this API is: https://id.pace.cloud/auth/realms/pace/.well-known/openid-configuration.