8. Sending cyber proctor warnings to LMS in real time

Constructor Proctor can send warnings during a proctored session in real time if required and if the corresponding endpoint is provided. Every time when AI (cyber proctor) detects a warning, Constructor Proctor will make a request with that warning to the LMS.

Before activating this feature make sure that your server is ready for a large number of requests.

API URL:

[warning_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",
  "type": "WARNING_AVERT_EYES",
  "start": "2018-07-19T12:05:25+00:00",
  "end": "2018-07-19T12:06:01+00:00",
  "cyber": true,
  "id": 1
}

The method fields are described in the table below:

Field	Type	Description
accountId*	string	Company ID in LMS.
sessionId*	string	Session ID in LMS.
type*	string (enum)	Warning type.
start*	string (datetime)	Date and time of the warning start (ISO 8601).
end*	string (datetime)	Date and time of the warning end (ISO 8601).
cyber*	boolean	Parameter specifying whether the Cyber Proctor mode is used to generate warnings: * true — created by AI (cyber proctor) * false — created or confirmed by a human proctor The value is always true for this method.
id*	int	Warning ID in Constructor Proctor.