curl --request GET \
--header "XF-Api-Key: $FORUM_API_KEY" \
--header 'Accept: application/json' \
'https://forum.arzguard.com/api/demote/123/'
{
"groups": {
"8": "Условная группа"
}
}
Повышение и снятие
Снятие: доступные группы
Возвращает группы, которыми текущий пользователь вправе управлять через Promote API.
GET
/
api
/
demote
/
{user_id}
/
curl --request GET \
--header "XF-Api-Key: $FORUM_API_KEY" \
--header 'Accept: application/json' \
'https://forum.arzguard.com/api/demote/123/'
{
"groups": {
"8": "Условная группа"
}
}
Возвращает группы, доступные инициатору для изменения форумных дополнительных групп.
Форматы тела запроса и общая обработка ошибок описаны в разделе «Запросы и ошибки».
Доступ
Требуется scopeuser:promote, право пользователя general/promoteAllow и хотя бы одна группа, которой он может управлять. Эти собственные проверки выполняются и при запросе обхода стандартных прав XenForo.
string
required
Обязательный ключ API XenForo. Тип ключа и пользовательский контекст описаны в разделе «Авторизация».
Параметры
integer
required
Положительный ID форумного пользователя. В этом GET используется только для сопоставления маршрута: целевой профиль не загружается.
Результат
object
Сопоставление ID групп и их названий. Ключи JSON-объекта — строки с числовыми ID.
Поведение
Доступные группы определяются настройкойgroups_that_can_promote: она должна содержать основную или одну из дополнительных групп инициатора. Метод чтения не меняет группы целевого пользователя. Список не ограничивается группами, уже назначенными ID из пути; у обоих GET-маршрутов одинаковая логика.
Все ID и данные в примерах условные. FORUM_API_KEY — заранее настроенная переменная окружения; действующий ключ в документации не приводится.
curl --request GET \
--header "XF-Api-Key: $FORUM_API_KEY" \
--header 'Accept: application/json' \
'https://forum.arzguard.com/api/demote/123/'
{
"groups": {
"8": "Условная группа"
}
}