Skip to main content
POST
Изменяет баланс сотрудника на выбранном сервере. Баллы передаются целым числом сотых долей: 100 означает 1 балл. Используйте актуальную revision и заголовок Idempotency-Key.

Доступ

personnel:points_add для начисления или personnel:points_deduct для списания.
string
required
Партнёрский Bearer-токен. Подробнее в разделе «Авторизация».

Особенности

Сначала откройте метод подготовки. Перед выполнением операции возьмите revision из его ответа и передайте её как revision.

Параметры

string
required
Уникальный ключ действия: от 16 до 128 печатных ASCII-символов без пробелов. При повторе того же запроса используйте тот же ключ. Для нового действия создайте новый. До 128 символов.

Тело запроса

Передайте JSON с заголовком Content-Type: application/json.
object
required
object
required
Модератор, который инициировал действие через бота. CRM определяет его аккаунт по привязанному внешнему ID и проверяет полномочия.

Успешный ответ

HTTP 200. Запрос выполнен успешно.
integer | null
required
Текущий баланс в сотых долях балла. Null, если баланс не определён.
boolean
required
Есть ли полномочия на изменение баллов у модератора. Боту дополнительно нужно право на выбранную операцию.
string
required
Ревизия текущего состояния. Передавайте актуальное значение, полученное при подготовке действия или чтении состояния.
string
required
Идентификатор сервера CRM (UUID). Сервер должен входить в выданный боту доступ.Формат uuid.
string
required
Идентификатор сотрудника в CRM, в том числе незарегистрированного участника состава (UUID).Формат uuid.

Ошибки

См. формат ошибок и правила повторов.

Пример

Подставьте свои ID, а для изменения используйте отдельный ключ операции и ревизию из CRM.