ДОСТУПНО В BUSINESS ПОДПИСКЕ
Метод: withdrawGamificationPoints
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| token (обязательный) | string | Токен доступа. Вы можете получить токен с помощью запроса |
| userId (обязательный) | string | ID пользователя, которому будут начислены баллы |
| amount (обязательный) | string | Количество баллов для списания |
| reason (обязательный) | string | Причина списания баллов |
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками.
Администратор подразделения или пользователь с ролью с индивидуальными настройками могут списать баллы только пользователям своего подразделения и вложенных в него подразделений.
Методы добавления и удаления баллов не работают, если у вас ограничен доступ к изменению пользователей (см. Настройки роли).
Возможные ошибки
| Тип | Описание |
|---|---|
| Permission denied | Недостаточно прав у пользователя для изменения пользователей |
| Wrong parameters | Не удалось обработать запрос, т.к. он не включает все нужные параметры или они заданы неверно |
Пример запроса
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns="https://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<WithdrawGamificationPointsRequest>
<credentials>
<token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
</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="https://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <ns1:SuccessResult> <ns1:success>true</ns1:success> </ns1:SuccessResult> </SOAP-ENV:Body> </SOAP-ENV:Envelope>