Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

General Information

...

ServiceAPIMethodData ModelsWorkflow
oauth/pinPOSTN/AN/A

Description

This API allows the user to login by pin or enable pin login and create a tokenwith pin.

Input

...

Type: application/json
NameSourceMandatoryTypeSpecial FormatDescription
pinBodyNOStringN/APin
grant_typeBodyYESString

"enum": ["refresh_token", "password"]

Grant Type
refresh_tokenBodyNOStringN/ARefresh token

Output

...

Response

SOAJS has a unified response. Check out this link to understand more the schema of SOAJS response 

Valid Response

Code Block
languagejs
titleValid Response Sample
linenumberstrue
collapsetrue
{
    "token_type": "bearer",
    "access_token": "%oauth_access_token_value%",
    "expires_in": 3600,
    "refresh_token": "%oauth_refresh_token_value%"
}

Invalid Response

Code Block
languagejs
titleError Response Sample
linenumberstrue
collapsetrue
{
    "result":false,
    "errors":{
        "codes":[406],
        "details":[
            {
                "code":406,
                "message":"Missing Tenant secret"
            }
        ]
    }
}

Response schema

Follow this link to check out the response JSON Schema

SOAJS Error Codes



Code
Description
406

Missing Tenant secret

503

Pin login is not available for this account