Предпросмотры ссылок превращают веб-адреса, которыми делятся в чате, в наглядные карты Markdown на основе метаданных, уже опубликованных на странице.
Метаданные
- Open Graph: заголовок, описание, изображение, URL и название сайта
- Запасные варианты Twitter/X Card: заголовок, описание, изображение и URL
- Запасные варианты Schema.org JSON-LD: заголовок, описание, изображение, издатель и поставщик
- Запасные варианты: заголовок HTML, описание и канонический URL
- oEmbed JSON, найденный в ссылках страницы или в заголовках HTTP Link
В беседе
Вставьте ссылку в канал или в личное сообщение, и её карта появится под сообщением: с источником, заголовком, автором и временем чтения, собственным изображением страницы и кратким описанием.
Карточка читается из архива при отрисовке разговора, поэтому она сохраняется после перезагрузки и снова на месте, когда вы прокручиваете назад. Если страницу ещё никто не читал, сообщение остаётся без изменений, пока не завершится загрузка, после чего карточка появляется сама. Если отключить форматирование текста, карточки скрываются вместе с остальным оформлением.
Только простые сообщения получают карту, и только для их первой ссылки. Сообщение, которое вы пишете в Markdown, оставлено точно так же, как вы его написали — вы уже выбрали, как должна выглядеть ссылка, и именно поэтому собственная карта бота фид никогда не предоставляется второй.
Где используется
RSS-боты публикуют новые элементы фид в виде одной и той же карты, поэтому элемент фид и ссылка, которую кто-то вставил, читаются одинаково.
Каждый пользователь читает из одного общего архива. Страница извлекается в первый раз, когда кто-либо ссылается на нее и хранится в течение 120 дней, поэтому та же ссылка, размещенная на другом канале или опубликованная позже фид-ботом, отвечает без повторного контакта с сайтом.
Когда сохранённая страница устаревает, она обновляется условным запросом, на который большинство сайтов отвечают «без изменений» — ни одна страница не скачивается дважды, если она на самом деле не изменилась.
Безопасность
- Загружаются только URL с HTTP и HTTPS
- URL со встроенными учётными данными отклоняются
- Частные, локальные, документационные, тестовые, многоадресные и зарезервированные диапазоны адресов блокируются
- Перенаправления и найденные URL oEmbed/image проверяются перед использованием
- Изображения Markdown очищаются, загружаются отложенно и отображаются без утечки реферера
См. также
Сборщик ссылок · Возможность RSS у бота · Форматирование текста