Включить страницу | ||||
---|---|---|---|---|
|
Запрос: POST /enrollment
Информация |
---|
Важно:
|
Оглавление minLevel 2
Права для выполнения запроса
Чтобы назначить материалы пользователям, отправьте POST запрос на URL: /enrollment.
...
Владелец аккаунта, Администратор аккаунта, Администратор
...
подразделения или роль с индивидуальными настройками, которые позволяют создавать назначения.
Запрос
...
Администратор подразделения и пользователь с ролью с индивидуальными настройками могут назначать курсы только пользователям подразделений, которыми управляют, и вложенных в них подразделений.
Заголовки и параметры запроса
Authorization (обязательный) | Токен доступа. Вы можете получить токен с помощью запроса | |||||
Параметр | ||||||
---|---|---|---|---|---|---|
X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора аккаунта, Администратора подразделения, Автора или пользователя с ролью с индивидуальными настройками, которые позволяют создавать назначения. | |||||
Описание | ||||||
courseIds (обязательный) | ID курсов, которые вы хотите назначить | .|||||
learnerIds (обязательный) | ID учащихся, которым вы хотите назначить курсы | .|||||
accessDate (необязательный) | Дата и время начала обучения. Если дата | начала обучения и время не | указанауказаны, | будет будут автоматически подставлена | текущая текущие дата | .и время |
dueDateType (обязательный) | Параметр показывает, есть ли у курса срок выполнения или же он неограничен по времени. Возможные значения параметра: unlimited, default, due_date, due_period | .|||||
dueDate (обязательный) | Параметр обязателен, если dueDateType | =равен due_date | .||||
duePeriod (обязательный) | Параметр обязателен, если dueDateType | =равен due_period. Указывается в часах | .||||
Заголовки | Описание |
...
lockAfterDueDate (необязательный) | Параметр показывает, будет ли курс заблокирован после окончания срока выполнения. Возможные значения: false или true |
Заголовок | Описание |
---|
Коды ответов
201 |
Created | Новые назначения созданы |
400 | Bad Request | Ошибка в запросе |
401 | Unauthorized | Ошибка авторизации |
403 | Permission Denied | У |
пользователя недостаточно прав для создания назначений |
Код | Текст | Описание |
---|
Пример запроса
Блок кода | ||
---|---|---|
| ||
POST /enrollment HTTPhttps/1.1 Host: api-learn.ispringlearn.com X-Auth-Account-Url: http://myaccount.ispringlearn.com X-Auth-Email: email@email.com X-Auth-Password: 12345Qru Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE Content-Type:application/xml <?xml version="1.0" encoding="UTF-8"?> <request> <courseIds> <id>3fa85f64-5717-4562-b3fc-2c963f66afa6</id> </courseIds> <learnerIds> <id>3fa85f64-5717-4562-b3fc-2c963f66afa6</id> </learnerIds> <accessDate>2019-09-26 10:30:00</accessDate> <dueDateType>unlimited</dueDateType> <dueDate>2019-10-26 10:30:00</dueDate> <duePeriod>0</duePeriod> </request> |
Пример ответа
Блок кода | ||
---|---|---|
| ||
HTTPhttps/1.1 201 Successful operation Connection: closeCreated |