Включить страницу | ||||
---|---|---|---|---|
|
Запрос: POST /gamification/points/withdraw
Оглавление minLevel 2
Права для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками.
Администратор подразделения и пользователь с ролью с индивидуальными настройками могут списывать баллы у пользователей только в подразделениях, которыми управляют, и во вложенных в них подразделениях.
Заголовки и параметры запроса
Заголовок | Описание |
---|---|
Authorization (обязательный) | Токен доступа. Вы можете получить токен с помощью запроса |
Параметр | Описание |
userId (обязательный) | ID пользователя, у которого нужно списать баллы |
amount (обязательный) | Количество баллов для списания |
reason (обязательный) | Причина списания баллов |
Коды ответов
Код | Текст | Описание |
---|---|---|
200 | OK | Баллы успешно списаны |
400 | Bad Request | Ошибка в запросе |
401 | Unauthorized | Ошибка авторизации |
403 | Permission denied | У пользователя недостаточно прав для выполнения запроса |
Пример запроса
Блок кода | ||
---|---|---|
| ||
POST /gamification/points/withdraw https/1.1
Host: api-learn.ispringlearn.ru
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Content-Type: application/xml
Accept: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<withdrawGamificationPoints>
<userId>2c180ffc-8841-11e9-b68a-0242c0a85016</userId>
<amount>10</amount>
<reason>string</reason>
</withdrawGamificationPoints> |
Пример ответа
Блок кода | ||
---|---|---|
| ||
https/1.1 200 OK |