Статьи

Скриншот телефона или планшета

viewport_device выбирает пресет. Пресет записывает окно, масштаб устройства, touch, альбомную ориентацию и подходящий user agent. Ширину, высоту и масштаб вы по-прежнему можете заменить.

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

Идентификаторы пресетов

GET /api/v1/devices возвращает каждый идентификатор. В списке iphone_se, iphone_13, iphone_13_landscape, iphone_13_pro_max, iphone_13_pro_max_landscape, iphone_14, iphone_14_landscape, iphone_14_pro_max, iphone_14_pro_max_landscape, pixel_7, pixel_7_landscape, galaxy_s9+, galaxy_s9+_landscape, ipad, ipad_landscape, ipad_pro и ipad_pro_landscape. Сохранённое задание повторяет ширину, высоту, масштаб и user agent, которые применил пресет.

Экран, который вы задаёте сами

Обойдитесь без пресета и задайте viewport_width от 1 до 3 840 и viewport_height от 1 до 16 384. device_scale_factor идёт от 1 до 5 и по умолчанию равен 1: так запрашивают изображение retina. viewport_mobile, viewport_has_touch и viewport_landscape описывают устройство. user_agent заменяет строку браузера, до 500 символов. Если полей окна нет совсем, съёмка идёт при 1 440 на 900.

Альбомная ориентация и полная страница на телефоне

Альбомный пресет уже меняет стороны местами. viewport_landscape на своём размере меняет их местами, когда ширина всё ещё меньше высоты. full_page по-прежнему прокручивает это окно размером с телефон, поэтому мобильную главную можно снять целиком. Сочетайте пресет с block_cookie_banners, когда нужна вёрстка телефона, а диалог согласия не нужен.

Поля

Имена, которые принимает этот запрос
viewport_device Идентификатор пресета из GET /api/v1/devices. Задаёт окно, масштаб, touch, landscape и user agent.
viewport_width CSS-пиксели по ширине. От 1 до 3 840. По умолчанию 1 440, если окно не задано.
viewport_height CSS-пиксели по высоте. От 1 до 16 384. По умолчанию 900, если окно не задано.
device_scale_factor Плотность пикселей от 1 до 5. По умолчанию 1. У пресетов свой масштаб retina.
user_agent Строка браузера в запросе страницы, до 500 символов.

Вопросы

Какое поле отправить для iPhone 14?

viewport_device со значением iphone_14. Для телефона на боку возьмите iphone_14_landscape. Остальные идентификаторы перечисляет GET /api/v1/devices.

Можно ли оставить пресет iPhone и поменять только ширину?

Да. viewport_width, viewport_height и device_scale_factor заменяют значения пресета, если вы их отправили.

Меняет ли пресет телефона формат файла?

Нет. Формат по-прежнему PNG. Задайте JPG, WEBP или PDF в том же запросе, если нужен другой файл.

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

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

Сравнения

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

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