v1

latestOpenAPI 3.1.02026-07-14217.3 KB

Authentication Service

Generate Token

Authenticate using Basic Authentication with username/password or client credentials.

This endpoint is typically used by a web or mobile application at login when the user first enters their credentials.

Returns an access_token and, optionally, a refresh_token depending on the type of authentication.

Note: The refresh_token is only issued for web or mobile authentication users; it is not returned for machine-to-machine (M2M) authentication.

Header example:

Authorization: Basic base64(username:password)

post/api/auth/token

Response

Token generated successfully

access_tokenstring

JWT access token used to authenticate API requests.

token_typestring

The type of token issued, typically 'Bearer'.

expires_ininteger

The number of seconds until the access token expires.

refresh_tokenstring

Refresh token used to obtain a new access token. Previous refresh_token expires once a new one is issued.

Example response

{
  "access_token": "eyJhbGciOiJFUzI1NiJ9...",
  "token_type": "Bearer",
  "expires_in": 300,
  "refresh_token": "95CCF8D8-C4D1-4471-8DE5-4B695C065163"
}

All 2 operations