Вы можете списать баллы у выбранного пользователя с помощью метода withdrawGamificationPoints
Права пользователя для выполнения запроса: Владелец аккаунта, Администратор, Администратор подразделения.
Методы добавления и удаления баллов не работают, если у вас ограничен доступ к изменению пользователей (см. Настройки роли).
Параметры запроса
| Параметр | Тип | Описание |
|---|
| credentials (обязательный) | credentials | Смотрите описание объекта Credentials. |
| userId (обязательный) | string | ID пользователя, которому будут начислены баллы. |
| amount (обязательный) | string | Количество баллов для списания. |
| reason (обязательный) | string | Причина списания баллов. |
Возможные ошибки
| Тип | Описание |
|---|
| Permission denied | Недостаточно прав у пользователя для изменения пользователей. |
| Wrong parameters | Не удалось обработать запрос, т.к. он не включает все нужные параметры или они заданы неверно. |
Пример запроса
| Блок кода |
|---|
|
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns="http://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<WithdrawGamificationPointsRequest>
<credentials>
<accountUrl>http://myaccount.ispringlearn.ru</accountUrl>
<email>email@email.com</email>
<password>password</password>
</credentials>
<userId>2c180ffc-8841-11e9-b68a-0242c0a85016</userId>
<amount>80</amount>
<reason>Не прошел тренинг</reason>
</WithdrawGamificationPointsRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |
Пример ответа
| Блок кода |
|---|
|
<?xml version="1.0" encoding="UTF-8"?>
<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:SuccessResult>
<ns1:success>true</ns1:success>
</ns1:SuccessResult>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |