Статьи

Снять всю страницу

Съёмка Site2image захватывает всю страницу, пока вы это не отключите. Браузер прокручивает страницу, и контент, который подгружается по пути вниз, попадает в файл. Формат по умолчанию — PNG.

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

Что входит в полную страницу

full_page по умолчанию равен true. Окно начинается с 1 440 на 900, а capture_beyond_viewport по умолчанию равен true, поэтому снимок не остаётся на первом экране. Задайте full_page равным false, если нужен только этот экран. Отправьте CSS-селектор или clip, если нужна одна область, а не вся страница. Оба варианта разобраны в статье про элемент ниже.

Прокрутка, чтобы подгрузился ленивый контент

full_page_scroll по умолчанию совпадает с full_page. Перед съёмкой страница сдвигается вниз шагами. full_page_scroll_by — шаг в пикселях, от 50 до 5 000. full_page_scroll_delay — пауза между шагами, от 0 до 10 000 миллисекунд. Короткая пауза нужна, когда картинки или цены появляются только на следующем экране.

Высота, сшивка и ответ

full_page_max_height останавливает съёмку на высоте от 1 до 30 000 пикселей. full_page_algorithm принимает default или by_sections. by_sections берёт куски размером с окно и сшивает их, когда доступен libvips. Если сшивка недоступна, задание снимает обычную полную страницу. POST /api/v1/screenshots возвращает 202, пока идёт новая съёмка. Опросите id или задайте вебхук.

Поля

Имена, которые принимает этот запрос
full_page Снимает дальше первого экрана. По умолчанию true.
full_page_scroll Прокручивает страницу перед съёмкой, чтобы подгрузился ленивый контент. По умолчанию совпадает с full_page.
full_page_scroll_by Пикселей на шаг прокрутки, от 50 до 5 000.
full_page_scroll_delay Миллисекунды между шагами прокрутки, от 0 до 10 000.
full_page_max_height Остановить страницу на высоте от 1 до 30 000 пикселей.
full_page_algorithm default или by_sections, чтобы сшить куски окна, когда доступен libvips.

Вопросы

По умолчанию уже снимается вся страница?

Да. Не передавайте full_page, и съёмка прокрутит всю страницу при 1 440 на 900. Для одного экрана задайте full_page равным false.

Как не превратить очень длинную страницу в одно огромное изображение?

Задайте full_page_max_height или сохраните страницу вертикальными фрагментами. Фрагментам нужен full_page, и они есть только у PNG, JPG и WebP.

Вызов сразу возвращает изображение?

Новая съёмка возвращает 202 и id. Заберите этот id, когда статус станет ready, или задайте callback_url и получите подписанный URL файла в вебхуке.

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

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

Сравнения

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

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