ipr.test.attempt.start
Scope:
iprКто может вызывать: Сам пользователь (
userId == актор) либо тот, кто им управляет (canManageEmployee). Подробнее: Модель доступа
Начинает новую попытку прохождения теста: создаёт запись попытки и формирует набор вопросов попытки по настройке теста.
HTTP: POST
Побочные эффекты: Создаёт попытку и связанные строки результатов по каждому вопросу теста.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
testId (алиас id) |
int |
да | ID теста |
userId |
int |
нет | Пользователь, для которого стартует попытка. По умолчанию — текущий пользователь |
Возвращаемые данные
Та же форма, что у ipr.test.result.get — свежесозданная попытка с пустыми ответами.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
VALIDATION_ERROR |
testId не передан; у теста нет вопросов для попытки (проверьте questionsFrom и привязку вопросов к курсу/уроку) |
NOT_FOUND |
Тест не найден |
PERMISSION_DENIED |
Нет прав запускать попытку за указанного userId |
INTERNAL_ERROR |
Не удалось создать попытку |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.test.attempt.start.json"
-H "Content-Type: application/json"
-H "Accept: application/json"
--data '{"testId": 44}'
Пример ответа
{
"result": {
"result": {
"id": 9001,
"testId": 44,
"userId": 15,
"status": "B",
"completed": false,
"score": 0,
"maxScore": 0,
"dateStart": "2026-06-18 12:00:00",
"dateEnd": null,
"answers": [
{ "id": 30001, "questionId": 501, "response": "", "answered": false, "point": 0, "correct": false }
]
},
"total": null,
"next": null,
"error": null
}
}
См. также
Предыдущая
Следующая