Auth

Returns a JSON with the user's full name and a TOKEN used for all operations.

POST http(s)://MyThinfinityServer:[Port]/__ds@[your-domain]__/dirsvc/api/v1/auth/login

Headers

Name	Type	Description
Authorization	String	Bearer TOKEN

Request Body

Name	Type	Description
"username"	String	The user name for login
"password"	String	The password for login in clear text

200: OK

{
    "data": {
        "user": {
            "username": "full userid"
        }
    "token": "7B6718ED0F914EAB857F0A8AF54C0CB6", //Token example
    "tokenExpiration": 600
     }
 }

401: Unauthorized

{
    "data": {},
    "error": {
        "code": 1326,
        "message": "The data is invalid"
    }
}

Changes a user's password to a new one

POST http(s)://MyThinfinityServer:[Port]/__ds@[your-domain]__/dirsvc/api/v1/auth/changepassword

Headers

Name	Type	Description
Authorization	String	Bearer TOKEN

Request Body

Name	Type	Description
"userid"*	String	"userid": "myUser"
"oldPassword"*	String	"oldPassword": "myOldPassword",
"newPassword"*	String	"newPassword": "myNewPassword"

400: Bad Request Incorrect Password

{
    "data": {},
    "error": {
        "code": 86,
        "message": "The specified network password is not correct"
    }
}

400: Bad Request Password requirement not met

{
    "data": {},
    "error": {
        "code": 2245,
        "message": "The password does not meet the password policy requirements. Check the minimum password length, password complexity and password history requirements"
    }
}

400: Bad Request User name not found

{
    "data": {},
    "error": {
        "code": 2221,
        "message": "The user name could not be found"
    }
}

200: OK Password Changed

{
    "data": {}
}

Request Example:

/auth/login

JSON in Body

{
    "userid": "myUser",
    "password": "myPasswod"
}

/auth/changepassword

JSON in Body

{
        "userid": "myUser",
        "oldPassword": "myOldPassword",
        "newPassword": "myNewPassword"
}