API. Создание экзамена со стороны тест-системы
Обычно экзамен в системе прокторинга создается автоматически, когда происходит первый переход по ссылке начала тестирования. Тем не менее, иногда может понадобиться создавать экзамен в системе прокторинга заранее. Для этого система заказчика может обратиться на API Examus, сделав POST-запрос со своего сервера. Также можно изменить существующий экзамен, если при запросе указать уже существующий examId и новые параметры экзамена.
API URL:
https://[examus_url]/api/v2/integration/simple/[integration_name]/exams/
Тип запроса:
POST
Заголовки запроса:
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MTI5OTQxMzF9.PRzN
Подпись JWT позволяет проверить, что запрос идет от системы заказчика и что токен сгенерирован в момент запроса. В payload токена содержится дата и время истечения токена в числовом формате Unix timestamp. Для вычисления этого времени можно использовать формулу “текущее время + 30 секунд”.
Пример JWT payload:
{
"exp": 1612994131
}
В теле запроса указываются те же параметры организации и параметры экзамена, что и для запуска тестирования с прокторингом.
Пример JSON-тела запроса:
{
"accountId": 123,
"accountName": "Название компании",
"examId": "unique-exam-id",
"courseName": "Физика",
"examName": "Финальный тест",
"userAgreementUrl": "https://school.org/eula",
"duration": 120,
"schedule": true,
"auxiliaryCamera": false,
"proctoring": "online",
"identification": "passport",
"trial": true,
"rules": {
"allow_to_use_paper": true,
"allow_to_use_calculator": false
},
"startDate": "2018-03-27T00:00:00Z",
"endDate": "2018-03-30T12:55:00Z",
"scoreConfig": {
"cheaterLevel": 80,
"extraUserInFrame": 1.0,
"substitutionUser": 1.0,
"noUserInFrame": 1.0,
"avertEyes": 1.0,
"changeActiveWindowOnComputer": 1.0,
"forbiddenDevice": 1.0,
"voiceDetected": 1.0,
"phone": 1.0
},
"visibleWarnings": {
"warning_extra_user_in_frame": false,
"warning_timeout": false
}
}
Экзамус отвечает статусом 201 Created, если в результате запроса экзамен был создан, и статусом 200 OK, если существующий экзамен был изменен. В теле ответа возвращаются актуальные параметры экзамена.