...
...
General Information
...
| Service | API | Method | Data Models | Workflow |
|---|---|---|---|---|
| oauth | /token | POST | N/A | N/A |
Description
This API allows the user to login and create a an access and refresh token.
Input
...
Type: application/json
| Name | Source | Mandatory | Type | Special Format | Description |
|---|---|---|---|---|---|
| username | Body | NO | String | N/A | Username |
| password | Body | NO | String | N/A | Password |
| grant_type | Body | YES | String | "enum": ["refresh_token", "password"] | Grant Type |
| refresh_token | Body | NO | String | N/A | Refresh token |
Output
...
Response
SOAJS has a unified response. Check out this link to understand more the schema of SOAJS response
Valid Response
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"token_type": "bearer",
"access_token": "%oauth_access_token_value%",
"expires_in": 3600,
"refresh_token": "%oauth_refresh_token_value%"
} |
Invalid Response
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"result":false,
"errors":{
"codes":[406],
"details":[
{
"code":406,
"message":"Missing Tenant secret"
}
]
}
} |
SOAJS Error Codes
Code | Description |
|---|---|
| 406 | Missing Tenant secret |
| 414 | Local login is not allowed |
| 503 | You do not have privileges to enable pin login |
| 503 | Unable to log in the user. User not found |