gamification.rating.board.place
Scope:
gamificationКто может вызывать: Только admin или manager. Подробнее: Права доступа
Разместить победителя рейтинга на доске почёта.
HTTP: POST
Побочные эффекты: создаёт или обновляет запись на доске почёта.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
ratingId |
int |
да | ID рейтинга (псевдонимы: id, ID) |
userId |
int |
нет | ID пользователя-победителя. По умолчанию — текущий пользователь |
Возвращаемые данные
result.result — данные о размещении на доске.
Обработка ошибок
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
ACCESS_DENIED |
Вызывающий не является admin/manager |
VALIDATION_ERROR |
Не передан ratingId |
USER_NOT_FOUND |
Пользователь не найден |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/gamification.rating.board.place.json" \
-H "Content-Type: application/json" \
-d '{"ratingId": 1, "userId": 42}'
Предыдущая
Следующая