Confirm User Credential

The user's credential to be sent to the ENSIMS Web Service include the registered email address and the password, along with the existing session token to confirm the current session.

• Method: POST
• Target: https://api.ensims.com/users/api/confirm
• Cookies: JWT session token
• Header: Set Content-Type to application/json
• Body: User credential object
• Success: Confirmation return object
• Failed: Confirmation failed object or HTTP 401 - Unauthorized

{
    "email": "yi@jeplus.org",
    "password": "********"
}

A successful authorization return object contains the status flag, message, user's name, email address, and a new JWT, as shown in the example below.

{
  "ok" : true,
  "status" : "User credential confirmed!",
  "jwt" : "Session key cookie",
  "user" : "Yi",
  "role" : "user",
  "email" : "yi@jeplus.org"
}

If the supplied user credential does not match the current session, a Failed response will be received:

{
  "ok" : false,
  "status" : "User does not match the existing session"
}

An HTTP 401 - Unauthorized response will be received

Assuming the session token has been saved in the cookies file using the log on command, send the confirm command using curl in Linux as below:

curl -b cookies -H 'Content-Type: application/json' -X POST -d '{"email": "yi@jeplus.org", "password": "********"}' https://api.ensims.com/users/api/confirm

If logged on successfully, an Auth return object with 'OK' status will be received with a new JWT. If the user's credential does not match the current session, a Failed object will be returned. If the session token is invalid, an HTTP 401 code will be returned.

Make sure Requests is correctly installed in your Python environment, and run the following lines:

import requests

headers = {'Content-Type': 'application/json'}
body = {"email": "yi@jeplus.org", "password": "********"}

# Make a post request. Session token must be available in the saved cookies during log-on
r = requests.post('https://api.ensims.com/users/api/confirm', headers=headers, json=body, cookies=cookies)

# Show return info
r.json()

A successful operation will return the JSON content such as the following:

{
  "ok" : true,
  "status" : "User credential confirmed!",
  "jwt" : "Session key cookie",
  "user" : "Yi",
  "role" : "user",
  "email" : "yi@jeplus.org"
}