Включить страницу | ||||
---|---|---|---|---|
|
Запрос: POST
...
/gamification/points/withdraw
withdraw Оглавление minLevel 2
Права
...
для выполнения запроса
: Владелец аккаунта, Администратор аккаунта, Администратор подразделенияподразделения или роль с индивидуальными настройками.
Администратор подразделения может начислять и подразделения и пользователь с ролью с индивидуальными настройками могут списывать баллы у пользователей только в своем подразделении и подразделениях, которыми управляют, и во вложенных в него них подразделениях.
Методы добавления и удаления баллов не работают, если у вас ограничен доступ к изменению пользователей (см. Настройки роли).
Параметры запроса
Заголовки и параметры запроса
Заголовок | Описание | |
---|---|---|
Authorization (обязательный) | Токен доступа. Вы можете получить токен с помощью запроса | |
Параметр | Описание | |
userId | ||
Параметр | Описание | |
X-Auth-Account-Url (обязательный) | Базовый URL аккаунта, например, http://myaccount.ispringlearn.ru | |
X-Auth-Email (обязательный) | Логин Владельца аккаунта, Администратора аккаунта или Администратора подразделения. | |
X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора аккаунта или Администратора подразделения. | |
(обязательный) | ID пользователя, у которого нужно списать баллы | .|
amount (обязательный) | Количество баллов для списания | .|
reason (обязательный) | Причина списания баллов | .
Коды ответов
Код | Текст | Описание |
---|---|---|
200 | Successful operationOK | Пароль Баллы успешно изменен.списаны |
400 | Bad Request | Ошибка в запросе. |
401 | Unauthorized | Ошибка авторизации. |
403 | Permission denied | Недостаточно У пользователя недостаточно прав у пользователя для выполнения запроса. |
Пример запроса
Блок кода | ||
---|---|---|
| ||
POST /gamification/points/withdraw HTTPhttps/1.1 Host: api-learn.ispringlearn.ru X-Auth-Account-Url: https://myaccount.ispringlearn.ru X-Auth-Email: email@email.com X-Auth-Password: password 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> |
Пример ответа
Блок кода | ||
---|---|---|
| ||
HTTPhttps/1.1 200 Successful operation Connection: closeOK |