V2 Get Token REST Service for OAuth Authentication

GET https://<hostname>/ws/rest/service/v2/auth/token

Purpose

Use this rest service with your credentials to fetch a JWT token to access V2 REST services. The token is valid for date/time available in the response. The token expiration is set to 3600 seconds by default.

Sample Request

Send an API request for a token with the end point URL included in the following curl command.

curl --location --request GET 'http://<HOST_NAME/ws/rest/service/v2/auth/token' \

--header 'Authorization: Bearer XXXXXXX'

Note: If the endpoint URL has a project number that contains special characters such as / \ : * ? " < > or |, you must change those special characters to URL escape characters. For example, a project number with a special number sign (hash) such as 2020#7 must be changed to 2020%7. You can use a browser to access the list of URL escape characters.

Optional Request Parameter

Use the following parameter to modify the token expiration in the API request:

Request Parameter	Data Type	Description
expiry	string	Enter the optional token expiration duration in seconds. For example, expiry=300.

Sample Success Response

{

"data": {

"endpoint": "rest1",

"access_token": "eyJ4NXQjUzI1NiI6ImhwYnAxMFpETU9mUUp3VzI4TnE4OU8tUVpoR19ZSDBPS1kwNHdyZTBtVjQiLCJ4NXQiOiJjTWxIdUZvTEZNdjdGWHRQbGlVNlZBQWdoLTQiLCJraWQiOiJTSUdOSU5HX0tFWSIsImFsZyI6IlJTMjU2In0.eyJjbGllbnRfb2NpZCI6Im9jaWQxLmRvbWFpbmFwcC5vYzEuaWFkLmFtYWFhYWFhYXF0cDViYWFmZnRoY2N0ZG5sZ2k3bnpjNnN2bjU0Ym40N2xpZXVnbzNsanJoY25ycGNucSIsInVzZXJfdHoiOiJBbWVyaWNhXC9Mb3NfQW5nZWxlcyIsInN1YiI6InZlbmthbm5hLmpha2thK3N0YWJsZTNkcnNAb3JhY2xlLmNvbSIsInVzZXJfbG9jYWxlIjoiZW4iLCJzaWRsZSI6NDgwLCJ1c2VyLnRlbmFudC5uYW1lIjoiaWRjcy0wNWQ0YWJlZmZlODA0N2M5OTY4ZTZjYThjYjk2NWQzMyIsImlzcyI6Imh0dHBzOlwvXC9pZGVudGl0eS5vcmFjbGVjbG91ZC5jb21cLyIsImRvbWFpbl9ob21lIjoidXMtYXNoYnVybi0xIiwiY2Ffb2NpZCI6Im9jaWQxLnRlbmFuY3kub2MxLi5hYWFhYWFhYXhicmRpZTdycW41NGdmaTZjaGlzdDZqdGpncGZ1dW80b3RxdjdoYmpoejRqdGV3bXEzbWEiLCJ1c2VyX3RlbmFudG5hbWUiOiJpZGNzLTA1ZDRhYmVmZmU4MDQ3Yzk5NjhlNmNhOGNiOTY1ZDMzIiwiY2xpZW50X2lkIjoiY2VnYnUtdW5pZmllci1kdmM0LTgwODYtcmVzdF9wcmltYXZlcmFjbG91ZGFwaWFwcF9jbGllbnRfQVBQSUQiLCJkb21haW5faWQiOiJvY2lkMS5kb21haW4ub2MxLi5hYWFhYWFhYWZqZ3BhdzNpcnh4c3JoZHB3c2U3cnFjYWR5cnpmNzNqYmx0azRieTRmbW56bHlzamRkYnEiLCJzdWJfdHlwZSI6InVzZXIiLCJzY29wZSI6InVybjpvcGM6aWRtOnQuc2VjdXJpdHkuY2xpZW50IiwidXNlcl9vY2lkIjoib2NpZDEudXNlci5vYzEuLmFhYWFhYWFhbG9zdWtyamxibzZwZ2F5NjZlb3VpYjJoamV6NDJmY3B3bnVuaWQ1ZTNxdzZsMm5uN3dicSIsImNsaWVudF90ZW5hbnRuYW1lIjoiaWRjcy0wNWQ0YWJlZmZlODA0N2M5OTY4ZTZjYThjYjk2NWQzMyIsInJlZ2lvbl9uYW1lIjoidXMtYXNoYnVybi0xIiwidXNlcl9sYW5nIjoiZW4iLCJ1c2VyQXBwUm9sZXMiOlsiQXV0aGVudGljYXRlZCJdLCJleHAiOjE3MDU1MTI2MTAsImlhdCI6MTcwNTUwOTAxMCwiY2xpZW50X2d1aWQiOiIzNmEzNTBiM2I5MjQ0ZTdkYmVjZmZhMTMwOGQ5NzNlZiIsImNsaWVudF9uYW1lIjoiY2VnYnUtdW5pZmllci1kdmM0LTgwODYtcmVzdF9wcmltYXZlcmFjbG91ZGFwaWFwcF9jbGllbnQiLCJ0ZW5hbnQiOiJpZGNzLTA1ZDRhYmVmZmU4MDQ3Yzk5NjhlNmNhOGNiOTY1ZDMzIiwianRpIjoiYWJlMjA3ZmQzZTFlNGRlMDgwMTQxNzFmYzdjNGMzYjAiLCJndHAiOiJybyIsInVzZXJfZGlzcGxheW5hbWUiOiJWZW5rYW5uYSBKYWtrYSIsIm9wYyI6dHJ1ZSwic3ViX21hcHBpbmdhdHRyIjoidXNlck5hbWUiLCJwcmltVGVuYW50IjpmYWxzZSwidG9rX3R5cGUiOiJBVCIsImF1ZCI6WyJodHRwczpcL1wvaWRjcy0wNWQ0YWJlZmZlODA0N2M5OTY4ZTZjYThjYjk2NWQzMy5pZGVudGl0eS5waW50Lm9jOXFhZGV2LmNvbSIsImh0dHBzOlwvXC9pZGNzLTA1ZDRhYmVmZmU4MDQ3Yzk5NjhlNmNhOGNiOTY1ZDMzLnVzLWFzaGJ1cm4tMS5zZWN1cmUuaWRlbnRpdHkucGludC5vYzlxYWRldi5jb20iLCJ1cm46b3BjOmxiYWFzOmxvZ2ljYWxndWlkPWlkY3MtMDVkNGFiZWZmZTgwNDdjOTk2OGU2Y2E4Y2I5NjVkMzMiXSwiY2FfbmFtZSI6ImNlZ2J1b3BjIiwic3R1IjoiQ0VHQlVMT0JCWSIsInVzZXJfaWQiOiI2Y2I5MzBhMjkxNjk0MWY2YWY4OWVkZjY1M2FiYTQxOSIsImRvbWFpbiI6ImNlZ2J1b3BjZGV2Y29ycDIiLCJjbGllbnRBcHBSb2xlcyI6WyJBdXRoZW50aWNhdGVkIENsaWVudCJdLCJ0ZW5hbnRfaXNzIjoiaHR0cHM6XC9cL2lkY3MtMDVkNGFiZWZmZTgwNDdjOTk2OGU2Y2E4Y2I5NjVkMzMuaWRlbnRpdHkucGludC5vYzlxYWRldi5jb206NDQzIn0.cE1nJlkekXPlQf5WuaxOBO4n2Lt7rWm5CPflkX-3oHzydDVnwUiCxpclM_Ret31MWULsNhUjltVh5MlEBzCs1c_AOjnm-MpjKMFoOtSZSohnm-8vNT_2GhdIw8xaeXteHYEba0e8yttldeC6yjsDHOfL9z99i7neeJjhuBHAvY3WfuZne_isnVGgKVQazY4OS01Yk4XeuHSu9OfKdRt_IJOmIgqrZGUmrEste3QzjbGhOB9zeZod6c2u-bX1ctHbiUyPUxkGYTYGKfzcnQN5IS3gi18jnyAuNRrTsbsvKOC6dSyOpWCZg4rg6CH0KXuN_X7B7amUeNxfG4S5Pm3kpg",

"expires_in": 3600,

"request_headers": {

"x-unifier-tenant-code": "tenant",

"x-unifier-tenant": "idcs-XXX"

}

"message": [],

"status": 200

}

Supported Response Parameters for OAuth Authentication

For OAuth authentication, the following parameters display with values in the response output:

Response Parameter	Data Type	Description
access_token	string	Displays the bearer token.
expires_in	string	Displays the expiry duration in seconds. By default, 3600 seconds.
endpoint	string	The end point for tenant REST calls.
request_headers	string	Contains the following tenant information: x-unifier-tenant-code x-unifier-tenant
message	string	Displays the error message.
status	string	Displays the http status code.

Supported HTTP Status Codes

The following HTTP status codes are supported for this rest service:

HTTP Status Code	Status Message	Error Message
200	Success	not applicable.
400	Bad Request	Invalid expiry.
401	Unauthorized	Empty or Invalid Authorization Header. Invalid Authorization Header
500	Internal Server Error	Please contact Administrator with Diagnostic code.

Supported HTTP Status Codes

Related Topics