Получить статистику по группе курса

GET /courses/{courseID}/groups/{groupID}/statistics

Получение статистики прохождения студентов конкретной группы.
В запросе указывается идентификатор курса {courseID} и идентификатор группы {groupID}. Эти идентификаторы можно получить запросом GET /organization/courses/groups.

МЕТОД HTTP

GET 

URL

https://userapi.mts-link.ru/v3/courses/{courseID}/groups/{groupID}/statistics

ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ

Отсутствуют.

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

  • pagination[offset] — позволяет отобразить результат, начиная не с первого массива данных. Например в результате с 10 пользователями, если установить pagination[offset]=3, их отобразится 7, отбросив первых трёх. Параметр не может быть отрицательным. По умолчанию значение 0.

  • pagination[limit] — ограничивает количество выдаваемых пользователей в ответе. Параметр не может иметь отрицательное число, либо 0.

  • filter[lastActivityFrom] — задает нижнюю границу даты и времени активности студента. Формат: dd-mm-yyyy;

  • filter[lastActivityTo] — задает верхнюю границу даты и времени активности студента.Формат: dd-mm-yyyy. 

ПОЛЯ ОТВЕТА

Передается массив данных обо всех Студентах, зарегистрированных на это событие и соответствующее заданному фильтру. Формат передаваемых данных:

  • contact — информация о контакте (из адресной книги), сквозная в рамках аккаунта. Передается в виде массива данных:
    - id  — идентификатор контакта;
    - firstName —  имя контакта;
    - lastName — фамилия контакта;

  • student — информация о студенте (studentid). Уникальны в рамках каждой группы курса. Если один и тот же участник записался в 2 группы курса - это 2 разных studentid.
    Передается в виде массива данных:
    -  id — идентификатор студента;
    - status — текущий статус студента. Значения:
        - active — активный;
        - successed — успешно завершивший;
        - invited — приглашенный, но незарегистрированный;
        - registered — зарегистрированный, но не начавший проходить курс;
        - paid — оплативший, но не приступивших к обучению;
        - on_moderation — ожидающий модерацию администратором;
        - failed — проваливший;
    -
    - registeredAt — дата регистрации студента на курс. Передается дата регистрации и часовой пояс, в котором эта дата отображена;
    - lastActivityAt — дата последней активности. Передается дата регистрации и часовой пояс, в котором эта дата отображена;

  • coursePassing — прогресс прохождения курса.
    Передаются значения полей:
    - status — статус в группе (все статусы описаны в запросе на получение группы);
    - passingProgress — процент прохождения уроков курса;
    - averageScore — набранный средний балл по всем заданиям с оценкой курса;

  • lessonsPassing — информация о прохождении уроков участником.
    Передается массив уроков. По каждому уроку пересылается следующая информация:
    - id — идентификатор урока;
    - name — название урока;
    - type — тип урока. Значения:
           - lesson — урок.Пост;
           - lessonTest — урок.Тест;
           - lessonWebinar — урок.Вебинар;
    - date —  дата и время прохождения с часовым поясом.
    Если участник не прошел урок то в поле будет значение null;

  • duration — время прохождения теста.

  • score — средний балл за тест. Только для уроков "Тест".

  • attempts — количество попыток, использованных участником.

ПРИМЕР ЗАПРОСА

url: https://userapi.mts-link.ru/v3/courses/{courseID}/groups/{groupID}//statistics?pagination[offset]=1& filter[lastActivityFrom]=17-09-2019
method: GET,
headers:
{
    x-auth-token: {Token},
    Content-Type: application/x-www-form-urlencoded
}

ПРИМЕР ОТВЕТА

200 OK
[
    {
        "contact": {
            "id": 50890937,
            "firstName": "Мария",
            "lastName": "Финогеева",
            "email": "m.finogeevan@gmail.com"
        },
        "student": {
            "id": 412435,
            "status": "invited",
            "registeredAt": {
                "date": "2019-10-02 08:54:22.000000",
                "timezone_type": 3,
                "timezone": "Europe/Moscow"
            },
            "lastActivityAt": {
                "date": "2019-10-02 08:54:22.000000",
                "timezone_type": 3,
                "timezone": "Europe/Moscow"
            }
        },
        "coursePassing": {
            "status": "open",
            "passingProgress": 0,
            "averageScore": 0
        },
        "lessonsPassing": [
            {
                "id": 16615,
                "name": "Новый урок",
                "type": "lesson",
                "date": null
            },
            {
                "id": 16655,
                "name": "Сертификаты",
                "type": "lessonTest",
                "date": {
"date": "2019-11-21 10:31:59.000000",
"timezone_type": 3,
"timezone": "Europe/Moscow"
{
"duration": 30,
                "score": 6.7,
"attempts": 3
            },
            {
                "id": 54975,
                "name": "Урок.Вебинар",
                "type": "lessonWebinar",
                "date": null
            }
        ]
    }
]
👆 На этом пока всё