Запрос: GET /learners/results
Заголовки
ПараметрЗаголовок | Описание |
|---|---|
| X-Auth-Account-Url (обязательный) | Базовый URL аккаунта, например, http://myaccount.ispringlearn.ru. |
| X-Auth-Email (обязательный) | Логин Владельца аккаунта, Администратора аккаунта, Администратора подразделения, Автора или пользователя с ролью с индивидуальными настройками. |
| X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора аккаунта, Администратора подразделения, Автора или пользователя с ролью с индивидуальными настройками. |
...
| userIds (необязательный) | ID пользователей, результаты которых вы хотите получить. |
| courseIds (необязательный) | ID курсов, результаты по которым вы хотите получить. Результаты по материалам, которые включены в составной курс, в рамках данного метода получить нельзя. |
| accessDate[startDate], accessDate[endDate] (необязательный) | Начальное и конечное ограничение по дате назначения курсов. Параметр может иметь только одну границу. |
| dueDate[startDate], dueDate[endDate] (необязательный) | Начальное и конечное ограничение по сроку выполнения курсов. Параметр может иметь только одну границу. |
| completionDate[startDate], completionDate[endDate] (необязательный) | Начальное и конечное ограничение по дате завершения курсов. Параметр может иметь только одну границу. |
| completionStatuses (необязательный) | Статус прохождения курсов, результаты по которым вы хотите получить. Возможные значения — not_started, in_progress, pending, complete, passed, accepted, incomplete, failed, declined. |
| departmentIds (необязательный) | ID подразделений, результаты которых вы хотите получить. |
| userStatuses (необязательный) | Статус пользователей. Может принимать следующие значения: 1 — активный, 3 — заблокированный. По умолчанию, в ответе выводятся данные по активным пользователям. |
| pageSize (необязательный) | Количество записей на 1 страницу. Если не указан, то 1000. |
| pageToken (необязательный) | Токен для перехода на следующую страницу выборки. Не указывается для первой страницы. |
Права для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения, Автор или роль с индивидуальными настройками.
Вы можете получить результаты по всему аккаунту, для определенных учащихся, для определенных курсов, а также указать статус пользователей, курсов, даты назначения и завершения, срок выполнения.
После того как запрос был успешно обработан, отправляется код ответа 200. Тело ответа будет содержать данные с информацией о результатах пользователей в xml.
Коды ответов
Код | Текст | Описание |
|---|---|---|
| 200 | Successful operation | Запрос успешно обработан. Тело ответа будет содержать данные с информацией о результатах пользователей в xml. |
| 400 | Bad Request | Ошибка в запросе. |
| 401 | Unauthorized | Ошибка авторизации. |
| 403 | Permission Denied | У пользователя недостаточно прав для получения списка назначений. |
...