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

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

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

. результаты
ЗаголовокОписание
X-Auth-Account-Url (required)Базовый URL аккаунта, например, https://myaccount.ispringlearn.ru.
X-Auth-Email (required)Логин Владельца аккаунтаАдминистратора, Администратора подразделения, Автора или пользователя с ролью с индивидуальными настройками.
Authorization (обязательный)Токен доступа. Вы можете получить токен с помощью запросаX-Auth-Password (required)Пароль Владельца аккаунтаАдминистратора, Администратора подразделения, Автора или пользователя с ролью с индивидуальными настройками.
ПараметрОписание

userIds (необязательный)

ID пользователей, результаты которых вы хотите получить
courseIds (необязательный)ID курсов,  результаты результаты по которым вы хотите получить
moduleIds (необязательный)ID модулей курса
courseItemIds (необязательный)ID материалов, результаты по которым вы хотите получить
enrollmentIds (необязательный)ID назначений, информацию по которым хотите получить

accessDate[startDate], accessDate[endDate] (необязательный)

Выборка по дате начала обучения. Можно указать только accessDateтолько accessDate[startDate] или accessDateили accessDate[endDate]
dueDate[startDate], dueDate[endDate] (необязательный)Выборка по по по по сроку выполнения курсов.  Можно Можно указать только dueDateтолько dueDate[startDate] или dueDateили dueDate[endDate].
completionDate[startDate], completionDate[endDate] (необязательный)

Выборка по дате завершения курсов пользователями. Можно указать только completionDateтолько completionDate[startDate] или completionDateили completionDate[endDate].

completionStatuses (необязательный)

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

  • not_started,
  • in_progress,
  • pending,
  • complete,
  • passed,
  • accepted,
  • incomplete,
  • failed,
  • declined
departmentIds  (необязательный)ID подразделений,  результаты результаты которых вы хотите получить
userStatuses (необязательный)

Статус пользователей.

Возможные значения:
1 —
1 — активный,

3 — 3 — заблокированный.

По умолчанию, в ответе выводятся данные по активным пользователям.По умолчанию, в ответе выводятся данные по активным пользователям

pageSize (необязательный)Количество записей на 1 страницу. Если не указан, то 1000.
pageToken (необязательный)Токен для перехода на следующую страницу выборки. Не указывается для первой страницы

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

.........0 — курс не просрочен.

Параметр

Описание

result

Массив с данными о результатах пользователя по материалам
userIdID пользователя
courseIdID курса
moduleIdID материала
moduleTitleНазвание материала
courseItemIdID материала или мероприятия, входящих в состав курса. 
Этот параметр указывает на ID материала или мероприятия, присвоенный в аккаунте, вне курса, и не совпадает с параметром moduleId
enrollmentIdID назначения
accessDateДата начала прохождения материала
dueDateСрок выполнения материала. Параметр указывается в ответе, если указан срок выполнения материала
expirationDateСрок выполнения материала. Параметр указывается в ответе, если доступ к курсу будет закрыт после срока выполнения
completionDateДата завершения курса
timeSpentВремя, потраченное на прохождение курса
completionStatus

Статус прохождения курсов.

Возможные значения:

  • not_started,
  • in_progress,
  • pending,
  • complete,
  • passed,
  • accepted,
  • incomplete,
  • failed,
  • declined
progressПрогресс прохождения курса
awardedScoreНабранный балл за курс
isOverdue

Является ли курс просроченным.

Возможные значения:

  • 0 — курс не просрочен,
  • 1 — курс просрочен
viewsCount Количество просмотров курса пользователем

Коды ответов

Код

Текст

Описание

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

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

Блок кода
languagexml
GET/learners/modules/results?userIds[]=85077abc-2639-11ea-8e3f-0a580af40c09&courseIds[]=f0e7400a-ca31-11e9-b6fc-0a580af40a22&moduleIds[]=5a98720f-41e2-11ea-8a66-0a580af40c6f&moduleIds[]=55e716fa-3c5c-11ef-96f2-02420a200177&moduleIds[]=6657451e-3c5c-11ef-ae43-02420a200177&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
X-Auth-Account-Url: https://my.ispringlearn.ru
X-Auth-Email: email@email.com
X-Auth-Password: password 
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE

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

Блок кода
languagexml
https/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <results>
        <result>
            <userId>114dba08-a75e-11eb-b4e5-0242ac13002a</userId>             
            <courseId>1852f94e<courseId>f0e7400a-a75eca31-11eb11e9-92c3b6fc-0242ac13002a<0a580af40a22</courseId>
            <moduleTitle>Course 1</moduleTitle>
            <courseTitle>Course 1</courseTitle><moduleId>5a98720f-41e2-11ea-8a66-0a580af40c6f</moduleId>
            <courseItemId>553964ac-3c5c-11ef-b1c4-02420a200163</courseItemId>                                                        
            <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<courseId>f0e7400a-a821ca31-11eb11e9-b84bb6fc-0242ac14002a<0a580af40a22</courseId>
            <moduleTitle>Course 2</moduleTitle>
          <courseTitle>Course 2</courseTitle>  <moduleId>55e716fa-3c5c-11ef-96f2-02420a200177</moduleId>
            <courseItemId>65a773eb-3c5c-11ef-b1c4-02420a200163</courseItemId>
            <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>f0e7400a-ca31-11e9-b6fc-0a580af40a22</courseId>
            <moduleTitle>Course  <courseId>401df18c-f37f-11eb-a842-0242ac130033</courseId>3</moduleTitle>
            <moduleId>6657451e-3c5c-11ef-ae43-02420a200177</moduleId>
            <courseTitle>Course 3</courseTitle><courseItemId>81fdb5be-3c5c-11ef-9bec-02420a200177</courseItemId>
            <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>

...