curl --request POST \
--header "Authorization: Bearer $PARTNER_TOKEN" \
--header 'Content-Type: application/json' \
--data-binary '{
"kind": "add",
"moderator": {
"provider": "discord",
"platform_user_id": "123456789012345678"
},
"target": {
"target_id": "01910000-0000-7000-8000-000000000002",
"server_id": 102
}
}' \
'https://test.crm.arzguard.com/api/partner/v1/personnel/points/options'
{
"balance_minor": 1,
"can_adjust": false,
"revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"server_id": "01910000-0000-7000-8000-000000000001",
"target_id": "01910000-0000-7000-8000-000000000002"
}
Баллы
Подготовить начисление или снятие баллов
Проверяет полномочия модератора и право бота на выбранную операцию.
POST
/
api
/
partner
/
v1
/
personnel
/
points
/
options
curl --request POST \
--header "Authorization: Bearer $PARTNER_TOKEN" \
--header 'Content-Type: application/json' \
--data-binary '{
"kind": "add",
"moderator": {
"provider": "discord",
"platform_user_id": "123456789012345678"
},
"target": {
"target_id": "01910000-0000-7000-8000-000000000002",
"server_id": 102
}
}' \
'https://test.crm.arzguard.com/api/partner/v1/personnel/points/options'
{
"balance_minor": 1,
"can_adjust": false,
"revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"server_id": "01910000-0000-7000-8000-000000000001",
"target_id": "01910000-0000-7000-8000-000000000002"
}
Проверяет полномочия модератора и право бота на выбранную операцию. Возвращает состояние и revision для изменения баллов без предоставления полной истории.
См. формат ошибок и правила повторов.
Доступ
personnel:points_add для начисления или personnel:points_deduct для списания.
Партнёрский Bearer-токен. Подробнее в разделе «Авторизация».
Параметры
Тело запроса
Передайте JSON с заголовкомContent-Type: application/json.
Модератор, который инициировал действие через бота. CRM определяет его аккаунт по привязанному внешнему ID и проверяет полномочия.
Успешный ответ
HTTP200. Запрос выполнен успешно.
Есть ли полномочия на изменение баллов у модератора. Боту дополнительно нужно право на выбранную операцию.
Ревизия текущего состояния. Передавайте актуальное значение, полученное при подготовке действия или чтении состояния.
Идентификатор сервера CRM (UUID). Сервер должен входить в выданный боту доступ.Формат
uuid.Идентификатор сотрудника в CRM, в том числе незарегистрированного участника состава (UUID).Формат
uuid.Ошибки
| HTTP | Значение |
|---|---|
400 | Некорректные параметры запроса. |
401 | Токен отсутствует, недействителен, отозван или не разрешён для этого IP-адреса. |
403 | Недостаточно прав у бота или указанного модератора; сервер или функция не входят в выданный доступ. |
404 | Запись не найдена или недоступна в данном контексте. |
409 | Конфликт состояния или ключа идемпотентности. Получите актуальную ревизию перед новым действием. |
422 | Данные не прошли проверку формата или ограничений. Подробности находятся в поле errors. |
429 | Превышен лимит запросов. Дождитесь интервала, указанного в заголовке Retry-After. |
500 | Внутренняя ошибка сервера. |
503 | Сервис временно недоступен. Повторите запрос позднее. |
Пример
В примере использованы условные идентификаторы.curl --request POST \
--header "Authorization: Bearer $PARTNER_TOKEN" \
--header 'Content-Type: application/json' \
--data-binary '{
"kind": "add",
"moderator": {
"provider": "discord",
"platform_user_id": "123456789012345678"
},
"target": {
"target_id": "01910000-0000-7000-8000-000000000002",
"server_id": 102
}
}' \
'https://test.crm.arzguard.com/api/partner/v1/personnel/points/options'
{
"balance_minor": 1,
"can_adjust": false,
"revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"server_id": "01910000-0000-7000-8000-000000000001",
"target_id": "01910000-0000-7000-8000-000000000002"
}