⚠️ Hi! When starting the integration, retreiving the token is of course the logical first step. But be sure to have ready the Integration core principles page before continuing your implementation.
GENERAL INFORMATION
This endpoint is used for retrieving the access token.
REQUEST
Authentication:
Authentication is passed in body of this call.
Headers:
Name | Description | Example |
|---|---|---|
X-Tenant | Tenant code supplied by Wair | “TENANT” |
QueryParameters:
No queryParameters required.
Body example:
{
"username": "user",
"password": "password01"
}Additional information:
Both username and password will be e-mailed to you when your environment has been created.
RESPONSE
StatusCodes:
200 = OK
401 = Unauthorized, which means an expired/missing/invalid token
400 = Bad request, see body of the response to check which validation errors have occured
500 = System error, see body of the response to check which error has occured or contact integration support
Body example:
{
"accessToken": "string",
"expiresIn": 0,
"tokenType": "string",
"scope": "string"
}Additional information:
accessToken = your temporary access token
expiresIn = when the access token expires in number of seconds
tokenType = type of token
scope = authorization scope