Полное справочное руководство по всем доступным RSS-каналам в Discourse, включая структуру URL, требования аутентификации и рекомендации по использованию для RSS-ридеров.
Требуемый уровень пользователя: Все пользователи
RSS (Really Simple Syndication) — это стандартизированный, машиночитаемый формат, который позволяет легко обмениваться контентом между сайтами и платформами. Discourse предоставляет широкий спектр RSS-каналов для тем, сообщений, категорий, тегов, пользователей и групп.
Стабильные URL: Ссылки RSS, содержащие идентификатор (например, идентификатор категории, темы или значка), определяются этим идентификатором. Ссылки не будут сломаны, если изменится «slug» (текстовая часть URL), но slug всё равно обязателен в пути URL.
Например, все эти ссылки ведут на один и тот же RSS-канал:
https://meta.discourse.org/t/events-plugin/69776.rsshttps://meta.discourse.org/t/a-random-slug/69776.rsshttps://meta.discourse.org/t/-/69776.rss
Значки (Badges)
Получите канал для конкретного значка.
https://meta.discourse.org/badges/[id]/[badge_name].rss
Категории
Получите канал с последними темами в конкретной категории.
https://meta.discourse.org/c/[category_slug]/[id].rss
Категории и теги
Получите канал тем в конкретной категории, которые также имеют определенный тег.
Важно: В отличие от стандартных каналов категорий, каналы «категория+тег» размещаются по пути
/tags/, а не/c/.
Канонический URL (Рекомендуется): Использует числовой ID тега для стабильности.
https://meta.discourse.org/tags/c/[category_slug]/[id]/[tag_slug]/[tag_id]/l/latest.rss
Устаревший URL: Использует только имя тега.
https://meta.discourse.org/tags/c/[category_slug]/[id]/[tag_name]/l/latest.rss
Примечание: Вы можете заменить latest другими фильтрами, такими как top, hot, new или unread.
Группы
Получите каналы активности групп. Работают оба префикса /groups/ и /g/.
Упоминания: Темы, в которых упоминается группа.
https://meta.discourse.org/groups/[group_name]/mentions.rss
или
https://meta.discourse.org/g/[group_name]/mentions.rss
Сообщения: Все сообщения, опубликованные участниками группы.
https://meta.discourse.org/groups/[group_name]/posts.rss
или
https://meta.discourse.org/g/[group_name]/posts.rss
Сообщения (Глобальные)
Получите канал всех публичных сообщений на всем сайте.
https://meta.discourse.org/posts.rss
Теги
Получите канал тем с определенным тегом.
Канонический URL (Рекомендуется): Использует числовой ID тега для стабильности.
https://meta.discourse.org/tag/[tag_slug]/[tag_id].rss
Устаревший URL: Использует только имя тега.
https://meta.discourse.org/tag/[tag_name].rss
Темы
Получите каналы списков тем.
Популярные темы (Hot): Темы, которые сейчас в тренде.
https://meta.discourse.org/hot.rss
Лучшие темы (по периоду): Самые популярные темы за определенный промежуток времени.
https://meta.discourse.org/top.rss?period=[period]
Где [period] — одно из значений: all, yearly, quarterly, monthly, weekly, daily.
top/yearly.rss) все еще работают, но перенаправляют на формат с параметром запроса, указанный выше.
Лучшие темы (По умолчанию): Использует период по умолчанию для сайта.
https://meta.discourse.org/top.rss
Последние темы: Темы с самой недавней активностью (ответами).
https://meta.discourse.org/latest.rss
Стабильный порядок для RSS-ридеров: По умолчанию «Latest» упорядочивается по времени последнего ответа. Это означает, что порядок элементов в вашем ридере будет меняться каждый раз, когда кто-то отвечает на старую тему. Чтобы получить стабильный хронологический порядок, основанный на времени создания тем, добавьте
?order=created:
https://meta.discourse.org/latest.rss?order=created
Одна тема: Канал для одной конкретной темы.
https://meta.discourse.org/t/[topic_slug]/[id].rss
Пользователи
Получите каналы активности конкретного пользователя. Работают оба префикса /users/ и /u/.
Сообщения: Все сообщения, опубликованные пользователем.
https://meta.discourse.org/users/[username]/activity.rss
или
https://meta.discourse.org/u/[username]/activity.rss
Темы: Темы, созданные пользователем.
https://meta.discourse.org/users/[username]/activity/topics.rss
или
https://meta.discourse.org/u/[username]/activity/topics.rss
Аутентифицированные каналы
Следующие каналы требуют, чтобы вы были авторизованы или предоставляли API-ключ. Они обеспечивают персонализированный просмотр контента.
- Непрочитанные темы: Темы, которые вы еще не читали.
https://meta.discourse.org/unread.rss - Новые темы (Персональные): Темы, новые для вас с момента вашего последнего посещения.
https://meta.discourse.org/new.rss - Прочитанные темы: Темы, которые вы уже прочитали.
https://meta.discourse.org/read.rss - Созданные темы: Темы, которые вы создали.
https://meta.discourse.org/posted.rss - Закладки: Темы, которые вы добавили в закладки.
https://meta.discourse.org/bookmarks.rss
/new.rss: URL/new.rssне существует для публичных, неавторизованных пользователей. Вид «New» специфичен для истории вашего аккаунта. Если вам нужен публичный канал тем, упорядоченных по дате создания, используйте/latest.rss?order=created.
Общие проблемы и решения
Проблема: «Страница отсутствует» или ошибка 404 на /new.rss
- Причина: Этот канал доступен только для авторизованных пользователей.
- Решение: Используйте
/latest.rss?order=createdдля публичного хронологического канала или убедитесь, что вы вошли в систему.
Проблема: Переупорядочивание элементов канала в моем ридере
- Причина: Канал
latestпо умолчанию сортируется по времени последнего ответа. - Решение: Добавьте
?order=createdв URL, чтобы сортировать по времени создания темы.
Проблема: Канал «Категория + Тег» не работает
- Причина: Использование префикса
/c/вместо/tags/c/. - Решение: Убедитесь, что URL начинается с
/tags/c/(например,https://site.com/tags/c/category-slug/1/tag-slug/2/l/latest.rss).
Часто задаваемые вопросы (FAQ)
В: Могу ли я создать RSS-канал для запроса поиска?
О: Нет, Discourse не поддерживает RSS-каналы для запросов поиска на нативном уровне. Вам необходимо использовать теги или категории для фильтрации контента.
В: Почему мои каналы категорий иногда показывают «Эта страница является частной»?
О: Если категория ограничена для определенных групп или пользователей, RSS-канал также будет ограничен. Вам необходимо войти в систему с соответствующими правами доступа, чтобы просмотреть канал.
В: Кэшируются ли RSS-каналы?
О: Да, Discourse кэширует RSS-каналы в течение 1 минуты для повышения производительности.
