7. Sending scheduling events to LMS

Constructor Proctor sends information about each scheduling event (when a test taker signed up for a proctored exam or canceled it) to the Testing Platform, if the following endpoint is provided.

API URL:

[schedule_url]

Request method:

POST

Request headers:

Content-Type: application/json  
Authorization: JWT eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MTI5OTQxMzF9.PRzN

The JWT signature is used to verify that the request sender is Constructor Proctor and that the token was generated exactly when the request was sent. In the payload the JWT contains the expiration date and time of the token in the numeric Unix timestamp format.

JWT payload example:

{
    "exp": 1612994131
}

Request body example:

{
  "accountId": 123,
  "sessionId": "b3875623",
  "event": "scheduled",
  "start": "2018-03-30T12:55:00Z",
  "cancelDeadline": "2018-03-29T12:55:00Z"
}

The method fields are described in the table below:

Field	Type	Description
accountId*	string	Company ID in LMS.
sessionId*	string	Session ID in LMS.
event*	string (enum)	The possible values are: * scheduled — user signed up for the exam * canceled — user unregistered from the exam
start	string (datetime)	Date and time of the planned exam start (UTC, ISO 8601).
cancelDeadline	string (datetime)	Date and time until when it is possible to unregister from the exam (UTC, ISO 8601). Can be the same as the start time.