Skip to content

AuthenticateUser

Use this endpoint to verify a user's organization login credentials and generate an authentication token.

Authenticates the user against Emakin's built-in organization login system. If the credentials are valid, the endpoint returns a login token within the scope of the registered API key. If authentication fails, it returns an empty string. This endpoint does not use external login providers.

Required Scope

login

Parameters

Parameter Name Description
apiKey A unique key used to authenticate and authorise the calling system.
logonId The user's organization login ID.
password The user's organization login password.

Example Call

1
2
3
4
5
6
7
POST https://mydomain.emakin.com/rest/v1/authenticateUser

{
     "apiKey": "xxxx",
     "logonId": "[email protected]",
     "password": "user-password"
}

1
2
3
4
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

"41AA3CE3CAFB..............BF8114"

If the user credentials are invalid, the response is an empty string:

1
2
3
4
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

""