Для получения списка назначений используйте метод getEnrollments.
Вы можете получить список назначений для всего аккаунта, для определенных учащихся и для определенных курсов, а также для двух параметров одновременно.
Права пользователя для выполнения запроса: Владелец аккаунта, Администратор аккаунта, Администратор подразделения, Автор или роль с индивидуальными настройками.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| credentials (обязательный) | credentials | Смотрите описание объекта Credentials. |
| courseIds (необязательный) | array | ID материалов, список назначений которых вы хотите получить. |
| learnerIds (необязательный) | array | ID пользователей, список назначений которых вы хотите получить. |
Возвращаемые значения
После того, как запрос успешно обработан, система отправляет объект со следующими свойствами:
| Параметр | Тип | Описание |
|---|---|---|
| enrollment | array | Массив, содержащий значения — ID подразделения, его название, код и родительское подразделение. |
Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://ispringlearn.com/go/services/api/soap">
<soapenv:Header/>
<soapenv:Body>
<soap:GetEnrollmentsRequest>
<soap:credentials>
<soap:accountUrl>https://myaccount.ispringlearn.ru</soap:accountUrl>
<soap:email>owner</soap:email>
<soap:password>12345Q</soap:password>
</soap:credentials>
<!--Optional:-->
<soap:courseIds>
<!--Zero or more repetitions:-->
<soap:id>14e2acf6-d54f-11e9-8339-0a580af40973</soap:id>
<soap:id>1689f3e8-d54f-11e9-ac87-0a580af40973</soap:id>
</soap:courseIds>
<!--Optional:-->
<soap:learnerIds>
<!--Zero or more repetitions:-->
<soap:id>d030ff3a-deb4-11e9-b26a-0a580af40764</soap:id>
<soap:id>8363b098-e031-11e9-89cf-0a580af40b0f</soap:id>
<soap:id>dcbe6062-deb4-11e9-88f1-0a580af40764</soap:id>
<soap:id>48b9dc96-deb6-11e9-85ba-0a580af40764</soap:id>
</soap:learnerIds>
</soap:GetEnrollmentsRequest>
</soapenv:Body>
</soapenv:Envelope>
Пример ответа
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<ns1:GetEnrollmentsResult>
<ns1:enrollment>
<ns1:enrollmentId>c8bbdd64-e031-11e9-8f79-0a580af40b0f</ns1:enrollmentId>
<ns1:courseId>146ac240-d54f-11e9-9b88-0a580af40973</ns1:courseId>
<ns1:learnerId>8363b098-e031-11e9-89cf-0a580af40b0f</ns1:learnerId>
<ns1:accessDate>2019-09-25</ns1:accessDate>
<ns1:dueDate>2019-09-30</ns1:dueDate>
<ns1:expirationDate>2019-09-30</ns1:expirationDate>
<ns1:shouldLockAfterDueDate>true</ns1:shouldLockAfterDueDate>
</ns1:enrollment>
...
</ns1:GetEnrollmentsResult>
</SOAP-ENV:Body>