ДОСТУПНО В BUSINESS ПОДПИСКЕ

Запрос: GET /learners/modules/results

Вы можете получить результаты по всему аккаунту, для определенных учащихся, для определенных курсов и материалов, а также указать статус пользователей, курсов, даты назначения и завершения, срок выполнения.

Узнайте, как получить список материалов курсов аккаунта, в статье Получение списка материалов курса (устаревший).

Права для выполнения запроса

Владелец аккаунта, Администратор аккаунта, Администратор подразделения, Автор или роль с индивидуальными настройками.

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

Заголовки и параметры запроса

Заголовок	Описание
Authorization (обязательный)	Токен доступа. Вы можете получить токен с помощью запроса
Параметр	Описание
userIds (необязательный)	ID пользователей, результаты которых вы хотите получить
courseIds (необязательный)	ID курсов, результаты по которым вы хотите получить
moduleIds (необязательный)	ID материалов, результаты по которым вы хотите получить
accessDate[startDate], accessDate[endDate] (необязательный)	Выборка по дате начала обучения. Можно указать только accessDate[startDate] или accessDate[endDate]
dueDate[startDate], dueDate[endDate] (необязательный)	Выборка по по сроку выполнения курсов. Можно указать только dueDate[startDate] или dueDate[endDate]
completionDate[startDate], completionDate[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 (необязательный)	Токен для перехода на следующую страницу выборки. Не указывается для первой страницы

Параметры ответа

Параметр	Описание
result	Массив с данными о результатах пользователя по материалам
userId	ID пользователя
courseId	ID курса
moduleId	ID материала
moduleTitle	Название материала
courseItemId	ID материала или мероприятия, входящих в состав курса.
enrollmentId	ID назначения
accessDate	Дата начала прохождения материала
dueDate	Срок выполнения материала. Параметр указывается в ответе, если указан срок выполнения материала
expirationDate	Срок выполнения материала. Параметр указывается в ответе, если доступ к курсу будет закрыт после срока выполнения
completionDate	Дата завершения курса
timeSpent	Время, потраченное на прохождение курса
completionStatus	Статус прохождения курсов. Возможные значения: not_started, in_progress, pending, complete, passed, accepted, incomplete, failed, declined
progress	Прогресс прохождения курса
isOverdue	Является ли курс просроченным. Возможные значения: 0 — курс не просрочен, 1 — курс просрочен
viewsCount	Количество просмотров курса пользователем

Коды ответов

Код	Текст	Описание
200	OK	Запрос успешно обработан. Тело ответа будет содержать данные с информацией о результатах пользователей в xml
400	Bad Request	Ошибка в запросе
401	Unauthorized	Ошибка авторизации
403	Permission Denied	У пользователя недостаточно прав для получения списка назначений

Пример запроса

GET/learners/modules/results?userIds[]=85077abc-2639-11ea-8e3f-0a580af40c09&courseIds[]=f0e7400a-ca31-11e9-b6fc-0a580af40a22&moduleIds[]=5a98720f-41e2-11ea-8a66-0a580af40c6f&accessDate[startDate]=2019-12-24T21:00:00Z&accessDate[endDate]=2020-12-30T03:00:00Z&dueDate[startDate]=2019-08-30T03:00:00Z&dueDate[endDate]=2019-12-30T03:00:00Z&completionDate[startDate]=2019-08-30T03:00:00Z&completionDate[endDate]=2019-12-30T03:00:00Z&completionStatus=failed&departmentIds[]=f0b2d3c0-aded-11e9-bfe6-0a580af40906&userStatuses[]=1&pageSize=33&pageToken=MmEzZTBiMjAtYmNmYi0xMWU5LTk2ODUtMGE1ODBhZjQwOTVj

https/1.1
Host: api-learn.ispringlearn.ru 
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE

Пример ответа

https/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <results>
        <result>
            <userId>114dba08-a75e-11eb-b4e5-0242ac13002a</userId>
            <courseId>1852f94e-a75e-11eb-92c3-0242ac13002a</courseId>
            <courseTitle>Course 1</courseTitle>
            <enrollmentId>b9b41af0-f062-11eb-a99d-0242ac190033</enrollmentId>
            <accessDate>2021-07-28T21:00:00+00:00</accessDate>
            <timeSpent>10</timeSpent>
            <completionStatus>in_progress</completionStatus>
            <progress>9.09</progress>
            <isOverdue>0</isOverdue>
        </result>
        <result>
            <userId>114dba08-a75e-11eb-b4e5-0242ac13002a</userId>
            <courseId>9d73e408-a821-11eb-b84b-0242ac14002a</courseId>
            <courseTitle>Course 2</courseTitle>
            <enrollmentId>bc2b7f9a-f066-11eb-bfc4-0242ac190033</enrollmentId>
            <accessDate>2021-07-28T21:00:00+00:00</accessDate>
            <dueDate>2021-07-29T21:00:00+00:00</dueDate>
            <expirationDate>2021-07-29T21:00:00+00:00</expirationDate>
            <timeSpent>0</timeSpent>
            <completionStatus>in_progress</completionStatus>
            <progress>50</progress>
            <isOverdue>1</isOverdue>
        </result>
        <result>
            <userId>114dba08-a75e-11eb-b4e5-0242ac13002a</userId>
            <courseId>401df18c-f37f-11eb-a842-0242ac130033</courseId>
            <courseTitle>Course 3</courseTitle>
            <enrollmentId>b44e7392-f389-11eb-b462-0242ac130033</enrollmentId>
            <accessDate>2021-08-01T21:00:00+00:00</accessDate>
            <dueDate>2021-08-03T21:00:00+00:00</dueDate>
            <timeSpent>0</timeSpent>
            <completionStatus>not_started</completionStatus>
            <isOverdue>1</isOverdue>
        </result>
    </results>
</response>

Дерево страниц

Получение результатов пользователей по материалам курсов