gamification.rating.monthResults
Scope:
gamificationКто может вызывать: Только admin или manager. Подробнее: Права доступа
Закрыть результаты месяца для рейтинга: зафиксировать победителей за указанный месяц/год. Идемпотентно по паре рейтинг + месяц + год.
HTTP: POST
Побочные эффекты: создаёт или обновляет архивные записи победителей месяца.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
ratingId |
int |
да | ID рейтинга (псевдонимы: id, ID) |
month |
int |
нет | Номер месяца (1–12). По умолчанию — прошлый месяц |
year |
int |
нет | Год. По умолчанию — текущий |
recalc |
bool |
нет | Выполнить пересчёт перед закрытием. По умолчанию false |
Возвращаемые данные
result.result — данные о зафиксированных результатах.
Обработка ошибок
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
ACCESS_DENIED |
Вызывающий не является admin/manager |
VALIDATION_ERROR |
Не передан ratingId |
ALREADY_PROCESSED |
Результаты за этот период уже зафиксированы |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/gamification.rating.monthResults.json" \
-H "Content-Type: application/json" \
-d '{"ratingId": 1, "month": 8, "year": 2026}'
Предыдущая
Следующая