Service Access Token

Requesting a service access token

post

Sends an authentication request and returns a service access token.

Note: We do not support refresh tokens for service access tokens. In case your service access token expires, you need to send a new authentication request.

Grant type parameter is always client_credentials.

Header parameters

Content-TypestringRequiredExample: application/x-www-form-urlencoded

Body

application/x-www-form-urlencoded

grant_typestringOptional

client_idstringOptional

client_secretstringOptional

scopestringOptional

Responses

200

The request was successful. A service access token is returned.

application/json

access_tokenstringOptional

token_typestringOptional

expires_ininteger · int32Optional

session_idle_timeinteger · int32Optional

refresh_tokenstringOptional

refresh_token_expires_ininteger · int32Optional

scopestringOptional

post

/oauth/token

HTTPcURLJavaScriptPython

POST /oauth/token HTTP/1.1
Host: api.emporix.io
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 125

"client_id='{client_id}'&client_secret='{client_secret}'&grant_type='client_credentials'&scope='tenant={tenant} ...'"

200

The request was successful. A service access token is returned.

{
  "refresh_token_expires_in": 0,
  "refresh_token": "",
  "session_idle_time": 120,
  "token_type": "Bearer",
  "access_token": "vkFuQ6oTwj8_Ye4eiRSsqMeqLYNeQRJi",
  "expires_in": 14399,
  "scope": "tenant={tenant} ..."
}