Ленты для читателей

Оповещения нужны вам, а лента — читателям. Если вы ведёте сайт, рассылку или отраслевую подборку, лента из опубликованного избавляет от ручного копирования: продукт сам отдаёт готовый поток новостей в понятном для программ виде.

Зачем лента

Лента — это адрес, по которому любая программа чтения новостей забирает ваши опубликованные материалы. Так одно и то же наполнение работает сразу в нескольких местах: на сайте, в рассылке, в агрегаторе, в чужой читалке. Ничего переписывать руками не нужно — опубликовали через продукт, и оно уже в ленте.

Три формата

  • RSS 2.0 — самый распространённый формат, его понимают почти все программы чтения.
  • Atom 1.0 — более строгий вариант того же самого.
  • JSON Feed 1.1 — тот же список новостей, но в формате, который удобно читать программам.

Содержание у всех трёх одно и то же — меняется только запись. Формат выбирается прямо в адресе: `.xml`, `.atom` или `.json`.

Адрес и токен

У каждой ленты свой адрес вида:

https://ваш-адрес/feeds/news.xml?token=ВАШ_ТОКЕН

Токен — это длинный пароль в адресе. Он проверяется каждый раз и сравнивается так, что по времени ответа нельзя ничего угадать. Если токен неверный или его забыли, лента отвечает «не найдено» — ровно так же, как будто её не существует. Так чужой человек не узнает даже, что у вас вообще есть лента, не говоря уже о её содержании.

Ленты создаются только с токеном: цель публикации без токена не сохранится. Открытых лент «для всех» в продукте нет — это сделано намеренно.

Что попадает в ленту

  • До 50 последних опубликованных материалов, новые сверху. Старое уходит из ленты само.
  • Полный текст, а не только заголовок: читатель получает заметку целиком.
  • Только опубликованное. Черновики и снятое с публикации в ленту не попадают.

Постоянные ссылки записей

У каждой записи в ленте есть постоянный номер, который не меняется от чтения к чтению. Это важнее, чем кажется: без него программы чтения показывали бы ваши новости повторно после каждой правки или перезапуска. А если вы переделали публикацию, это будет новая запись — читатели увидят её один раз, а не дважды.

Обновление токена

Если адрес ленты попал не туда, токен можно заменить одним действием. После замены старые адреса перестают работать, а всем, кому нужно, вы выдаёте новый. Прежние данные и опубликованные материалы при этом не трогаются.

Как часто обновляется лента

Лента отдаётся с разрешением хранить ответ пять минут. На практике это значит: новая публикация появится у читателей в течение нескольких минут, а частые обращения не создают лишней нагрузки. Для новостей этого более чем достаточно.

Дальше → Экраны наблюдения

← Оглавление документации