Статьи

Сохранить длинную страницу фрагментами

Некоторые страницы слишком высоки для одного удобного изображения. full_page_slices сохраняет съёмку всей страницы и дополнительно записывает вертикальные фрагменты. Каждый фрагмент — отдельный файл с подписанным URL.

Статьи по API скриншотов

Когда фрагменты разрешены

full_page_slices по умолчанию равен false. Ему нужен full_page, и принимается он только для PNG, JPG и WebP. PDF, HTML и Markdown это поле отклоняют. Высота фрагмента по умолчанию — 4 000 пикселей, допустимо от 100 до 16 000. Перекрытие по умолчанию — 0, допустимо от 0 до 16 000, но шаг от одного фрагмента к следующему должен оставаться не меньше 100 пикселей.

Что вы получаете обратно

Основной файл по-прежнему полная съёмка. Фрагменты идут вместе с ним. Готовый скриншот перечисляет их в GET /api/v1/screenshots/:id, а тело вебхука содержит массив slices, если фрагменты сохранены. У каждой записи есть подписанный URL. Одна съёмка хранит не больше 40 фрагментов. Увеличьте перекрытие, если иначе заголовок или карточка разрежутся пополам.

Чем это отличается от by_sections

full_page_algorithm со значением by_sections сшивает куски в одно изображение и переходит к обычной полной странице, если сшивка недоступна. full_page_slices ничего не сшивает. Куски остаются, чтобы клиент мог листать длинную статью или отчёт. Фрагменты нужны, когда потребитель хочет отдельные файлы. by_sections нужен, когда потребитель хочет одно изображение.

Поля

Имена, которые принимает этот запрос
full_page_slices Сохраняет вертикальные фрагменты вместе с полным изображением. По умолчанию false. Только PNG, JPG и WebP, и full_page должен быть true.
full_page_slice_height Высота каждого фрагмента в пикселях. По умолчанию 4 000. От 100 до 16 000.
full_page_slice_overlap_height Пиксели, повторённые у края следующего фрагмента. По умолчанию 0. Шаг между фрагментами должен оставаться не меньше 100 пикселей.
full_page Обязателен, когда фрагменты включены. Снимок одного окна разрезать нельзя.

Вопросы

Можно ли разрезать PDF на фрагменты?

Нет. Фрагменты сохраняются для PNG, JPG и WebP. У PDF вместо этого поля бумаги.

Где лежат URL фрагментов?

На скриншоте, когда он готов, и в теле вебхука, если вы задали callback_url. URL подписаны, как и у основного файла.

Сколько фрагментов получится со страницы?

Это зависит от высоты страницы, высоты фрагмента и перекрытия. Съёмка останавливается на 40 фрагментах.

Другие статьи

Альтернативы, которые используют эти поля

Сравнения

Отправьте первый адрес

Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.