REST API Kit 1.3

API Kit добавляет конечные точки, фильтры и сортировку в REST API XenForo. Он бесплатный, не имеет дополнительных функций и работает с любым API-ключом, которому вы предоставляете доступ.

Префиксы потоков​

• GET thread-prefixes/ перечисляет все префиксы потоков с указанием их названия, класса CSS и цвета метки.
• Каждый префикс в результатах API, в том числе в forums/{id}, получает colors: цвет текста, фона и границы, которые указаны в стиле по умолчанию для метки.

Цвета считываются из скомпилированного CSS-кода меток в стиле по умолчанию, поэтому отредактированные стили меток, темные стили и пользовательские классы CSS отображаются так, как их видят посетители. Отправляются только значения простых цветов; все, что нельзя интерпретировать как цвет, не отправляется.

API Kit обрабатывает цвета в фоновом режиме при изменении стиля по умолчанию или CSS-класса префикса. Запросы API считывают только сохраненный результат, поэтому они выполняются быстро.

Группы пользователей​

• GET user-groups/ перечисляет все группы пользователей с указанием их названия, приоритета отображения, CSS-имени пользователя и CSS-класса баннера.
• GET users/ получает user_group_id и secondary_group_ids[] фильтры. Пользователь должен входить во все дополнительные группы, которые вы укажете.

Сортировка тем​

GET threads/ теперь имеет две сортировки для списка тем на форуме:

• most_replies=1: темы, активные в течение последних 30 дней, отсортированы по количеству ответов, остальные — по последней активности
• most_viewed=1: темы, отсортированные по количеству просмотров

Настройка​

В разделе Настройка → Ключи API укажите для ключей, которым они нужны, следующие области действия:

• apikit_thread_prefix:read для thread-prefixes/
• apikit_user_group:read для user-groups/

Для цветов префиксов в других результатах дополнительная область видимости не требуется. Пользовательские фильтры используют собственные разрешения XenForo на user:read область действия и список участников, а сортировка по темам использует thread:read.