Статьи
Тег изображения не задаёт заголовок Authorization. GET /api/v1/screenshots/embed принимает access_token в query string, снимает страницу и возвращает файл. Токен виден в исходном коде страницы.
Параметры query — те же поля, что у POST /api/v1/screenshots. Закодируйте адрес страницы: https://example.com записывается как url=https%3A%2F%2Fexample.com. format по умолчанию равен PNG и также принимает JPG, WEBP и PDF. HTML и Markdown для встраивания не подходят. Вызов ждёт окончания съёмки и затем возвращает байты с типом содержимого вроде image/png или image/jpeg. Cache-Control равен private.
Кэш включён, пока вы не передадите cache=false. Тот же адрес, формат и параметры повторно используют последний готовый снимок в пределах cache_ttl. Окно по умолчанию — четыре часа. Встраивание из кэша не считается новой съёмкой в лимите. Промах кэша считается. У POST /api/v1/screenshots наоборот: кэш выключен, пока вы не зададите cache равным true, и попадание на этом маршруте всё равно считается.
GET /api/v1/screenshots/:id/embed перенаправляет на сохранённые PNG, JPG или WebP. PDF, HTML и Markdown на этом маршруте по id возвращают 404. Заголовок bearer принимается на обоих маршрутах встраивания, как и access_token. Отсутствующий токен возвращает 401. Токен без действующего тарифа возвращает 402. Новая съёмка сверх лимита возвращает 429. Неверный URL возвращает 422. Относитесь к токену в query как к паролю: кто видит тег, тот может создавать скриншоты этого аккаунта.
access_token |
Обязателен в query string для тега изображения. Заголовок bearer тоже подходит. |
|---|---|
url |
Страница, которую нужно снять. Закодируйте адрес. |
format |
По умолчанию PNG. На живом встраивании принимаются JPG, WEBP и PDF. |
cache |
По умолчанию true на этом маршруте. false заставляет снять заново. |
Из тега img — нет. Тег не отправляет заголовок. Создайте скриншот методом POST и отдавайте адрес, который контролируете вы, либо примите, что токен виден.
Первый вызов снимает страницу и только потом отвечает. Следующий вызов с теми же параметрами может взять эту съёмку в пределах окна кэша.
Да, если это готовые PNG, JPG или WebP. Используйте GET /api/v1/screenshots/:id/embed и передайте токен. Остальные форматы возвращают 404.
Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.