Set/Update JESS Session

Use POST /session with JESS account credential to set or update the JESS session associated with the user's ENSIMS Web Service account.

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

The JESS account credential is composed of a JESS username and password pair. You can obtain a JESS account by following the instructions here. Please note that this is a 2-step process and the credentials you need to use come from the email confirmation generated by the system, not your email address and password you have chosen during the registration on app.ensims.com.

The following JSON object is sent in the request's body with the transaction.

{
    "jessUser": "--------",
    "jessPwd": "********"
}

If the JESS credential is accepted, a new session key will be assigned to the user's ENSIMS Web Service account, and the user will be ready to run simulations. A successful return object contains the status flag and a message, as shown in the example below.

{
  "ok" : true,
  "status" : "New JESS session key is assigned.",
  "data" : null
}

If the supplied JESS credential does not match anything on the server, a Failed response will be received:

{
  "ok" : false,
  "status": "The supplied user and passwd pair does not match any record on JESS.",
  "data": null
}

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 on Linux as below:

curl -b cookies -H 'Content-Type: application/json' -X POST -d '{"jessUser": "--------", "jessPwd": "********"}' https://api.ensims.com/jess_web/api/session

on Windows:

curl -b cookies -H "Content-Type: application/json" -X POST -d "{\"jessUser\": \"--------\", \"jessPwd\": \"********\"}" https://api.ensims.com/jess_web/api/session

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

import requests

headers = {'Content-Type': 'application/json'}
body = {"jessUser": "--------", "jessPwd": "********"}

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

# Show return info
r.json()