К содержанию
SerpJet Документация Войти
Разделы
  1. Документация
  2. Публичный API доставки

HTML, JSON-LD, обложки, иллюстрации и безопасная обработка содержимого

Поле content — HTML статьи с иллюстрациями в тегах figure, cover — обложка WebP с размерами и alt, json_ld — разметка для вставки в script type=application/ld+json. Обрабатывайте HTML безопасно и не дублируйте заголовок.

Проверено
Содержание
  1. HTML статьи — content
  2. Обложка — cover
  3. Разметка — json_ld
  4. Безопасность

HTML статьи — content

  • Подзаголовки h2/h3, абзацы, списки, таблицы, ссылки.
  • Текст может начинаться с <h1> с заголовком статьи. Если тема CMS сама выводит заголовок записи из title, уберите h1 из содержимого, чтобы заголовок не повторялся.
  • Иллюстрации уже вставлены в текст:
    <figure data-sj-asset="…"><img src="…" alt="…" width="…" height="…"></figure>
    Изображения лежат по публичным стабильным адресам; их можно оставить по ссылке или скопировать в медиатеку CMS.

Обложка — cover

{"url": "https://…/cover.webp", "alt": "…", "width": 1536, "height": 1024}

Или null, если обложки нет. Изменение обложки или её alt даёт новую версию доставки, как изменение текста.

Разметка — json_ld

Объект schema.org для поисковых систем. Выводите его на странице статьи так:

<script type="application/ld+json">{…json_ld…}</script>

Данные автора и издателя берутся из настроек проекта «Данные для поисковых систем». Пустой объект — разметки нет.

Безопасность

  • Пропускайте HTML через санитайзер вашей CMS со списком разрешённых тегов: текст, заголовки, списки, таблицы, ссылки, figure/img.
  • json_ld вставляйте как JSON, экранируя </, а не как произвольный HTML.
  • Не выполняйте скрипты из содержимого.

Поля снимка — Справочник публичных методов, параметров, схем и примеров.

Не нашли ответ? Напишите в поддержку из панели — укажите проект и что вы видите на экране.