API. Создание тестирования со стороны тест-системы #932

  • Просмотров: 41

Обычно экзамен, сессия и пользователь в системе прокторинга создается автоматически, когда происходит первый переход по ссылке начала тестирования. Тем не менее, иногда может понадобиться создавать эти сущности в системе прокторинга заранее. Для этого система заказчика может обратиться на API Examus, сделав POST-запрос со своего сервера.

API URL:

https://[examus_url]/api/v2/integration/simple/[integration_name]/сreate/

Тип запроса:

POST

Заголовки запроса:

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

Подпись JWT позволяет проверить, что запрос идет от системы заказчика и что токен сгенерирован в момент запроса. В payload токена содержится дата и время истечения токена в числовом формате Unix timestamp. Для вычисления этого времени можно использовать формулу “текущее время + 30 секунд”.

Пример JWT payload:

{
"exp": 1612994131
}

В теле запроса указываются те же параметры, что и для запуска тестирования с прокторингом.

Пример JSON-тела запроса:

{
  "userId": "1232134",
  "lastName": "Иванов",
  "firstName": "Иван",
  "thirdName": "Иванович",
  "language": "ru",
  "accountId": 123,
  "accountName": "Название компании",
  "examId": "unique-exam-id",
  "courseName": "Физика",
  "examName": "Финальный тест",
  "userAgreementUrl": "https://school.org/eula",
  "duration": 120,
  "schedule": false,
  "checkIdPhotoQuality": true,
  "allowMultipleDisplays": true,
  "allowVirtualEnvironment": true,
  "auxiliaryCamera": false,
  "auxiliaryCameraMode": "photo",
  "proctoring": "offline",
  "identification": "passport",
  "rules": {
    "allow_to_use_paper": true,
    "allow_to_use_calculator": false
  },
  "desktopAppForbiddenProcesses": ["chrome.exe","Google Chrome"],
  "desktopAppAllowedProcesses": ["chrome.exe","Google Chrome"],
  "startDate": "2018-03-27T00:00:00Z",
  "endDate": "2018-03-30T12:55:00Z",
  "sessionId": "b3875623",
  "sessionUrl": "https://go.bananas.com/opentest#test/b3875623",
  "exp": 1612994131,
  "ldb": true,
  "biometricIdentification": {
    "enabled": true,
    "photo_url": "
    ",
    "skip_fail": false,
    "flow": "test-flow"
  },
  "scoreConfig": {
    "cheater_level": 70,
    "extra_user": 3.0,
    "phone": 0.0
  },
  "visibleWarnings": {
    "warning_extra_user_in_frame": false,
    "warning_timeout": false
  }
}

Экзамус отвечает статусом 201 Created, и данными созданного пользователя,экзамена и "ExamusSessionId" представляющим собой id сессии в системе прокторинга,что необходимо для API. Запуск заранее созданного тестирования тестирования с прокторингом