Статьи

Cookies, заголовки и место

Страницу можно запросить как вошедшего посетителя, в выбранном часовом поясе и в выбранной точке на карте. Эти значения уходят на страницу. К учётным данным API Site2image они не относятся.

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

Cookies и заголовки

cookies — список не длиннее 30. Каждый элемент — объект с name, value, domain, path, secure, http_only и same_site либо строка вроде name=value; Domain=example.com; Secure. same_site равен Lax, Strict или None. Домен должен быть целевым хостом, поэтому для cookies нужен url. headers — словарь имени и значения или список строк Name: value. Host, Connection и другие межузловые имена отклоняются. authorization — значение Authorization, которое уходит на страницу, до 1 024 символов. Это не bearer-токен Site2image.

Часовой пояс и геолокация

time_zone — имя IANA, например America/New_York или Europe/Berlin. geolocation_latitude и geolocation_longitude отправляются вместе. Широта идёт от -90 до 90, долгота — от -180 до 180. geolocation_accuracy — точность в метрах, от 0 до 100 000. user_agent заменяет строку браузера, до 500 символов. Пресет устройства тоже задаёт user agent, а явный user_agent его перекрывает.

Страницы, которые API не откроет

Адрес должен быть публичным http или https и не длиннее 2 048 символов. Localhost, имена .local и частные, loopback или link-local адреса отклоняются с кодом 422. ignore_host_errors продолжает работу, если основная навигация вернула ошибочный HTTP-статус. Оставьте false, если страница ошибки должна завершить задание с ошибкой. bypass_csp обходит Content-Security-Policy страницы, чтобы внедрённые стили и скрипты могли выполниться. HTML или Markdown в теле к хосту не обращаются.

Поля

Имена, которые принимает этот запрос
cookies До 30 cookies для целевого хоста. Объекты или строки cookie. Нужен url.
headers Дополнительные заголовки запроса. Словарь или список строк Name: value.
authorization Заголовок Authorization для страницы, до 1 024 символов. Это не токен API.
time_zone Часовой пояс IANA, например America/New_York.
geolocation_latitude Широта от -90 до 90. Долготу отправьте тоже.
geolocation_longitude Долгота от -180 до 180. Широту отправьте тоже.
ignore_host_errors Продолжать, если основная навигация вернула HTTP-ошибку. По умолчанию false.

Вопросы

Можно ли снять страницу за своим входом?

Да, если страница в публичном интернете и сессию можно передать как cookies или значение Authorization этого хоста. API не откроет localhost и частный адрес.

Куда поместить токен Site2image?

В заголовок Authorization вызова API: Bearer и токен доступа. authorization внутри JSON — другой заголовок, он уходит на страницу.

Нужны и широта, и долгота?

Да. Если отправить только одно значение, запрос отклоняется. Точность необязательна и задаётся в метрах.

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

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

Сравнения

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

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