Статьи
Страницу можно запросить как вошедшего посетителя, в выбранном часовом поясе и в выбранной точке на карте. Эти значения уходят на страницу. К учётным данным API Site2image они не относятся.
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 его перекрывает.
Адрес должен быть публичным 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 и частный адрес.
В заголовок Authorization вызова API: Bearer и токен доступа. authorization внутри JSON — другой заголовок, он уходит на страницу.
Да. Если отправить только одно значение, запрос отклоняется. Точность необязательна и задаётся в метрах.
Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.