Статьи

Создать скриншоты пакетом

POST /api/v1/screenshots/bulk принимает массив JSON или тело CSV. Каждый элемент использует те же поля, что и одиночное создание. Ответ сохраняет этот порядок. Неверный элемент или пустой массив возвращает 422 и не создаёт ничего.

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

JSON и короткие имена

Тело — массив JSON не более чем из 50 объектов. url обязателен в каждом объекте, если этот объект не отправляет html или markdown. file_type задаёт format. width и height задают viewport_width и viewport_height. Если заданы и короткое имя, и полное поле, используется полное поле. fresh со значением true снимает заново. fresh со значением false включает кэш, если cache ещё не задан.

CSV на входе и CSV на выходе

Отправьте Content-Type text/csv. Первая строка — заголовок, обязательный столбец — url. Остальные столбцы — те же поля, включая file_type, width, height, fresh и callback_url. Пробелы вокруг запятых игнорируются. Заголовок ответа — id,url. url в этом файле — адрес страницы, сохранённый у скриншота. Новый пакет возвращает 202. Если каждый элемент взят из кэша, ответ равен 200.

Лимиты и ассистенты

Пакет, который превысил бы месячный лимит или лимит в минуту, возвращает 429 и не создаёт ничего. В ответе 422 поле details разложено по индексу элемента. create_screenshots на адресе MCP принимает тот же массив под именем screenshots, и ожидание у него по умолчанию равно нулю. Одиночное создание нужно, когда адрес один. Пакет нужен, когда важен сам список.

Поля

Имена, которые принимает этот запрос
file_type Псевдоним format. PNG, JPG, JPEG, WEBP, PDF, HTML, MD или MARKDOWN.
width Псевдоним viewport_width.
height Псевдоним viewport_height.
fresh true снимает заново. false задаёт cache равным true, если cache ещё не задан.
callback_url Необязательный вебхук для этого элемента.

Вопросы

Какой размер пакета максимальный?

50 скриншотов. Массив больше этого, тело не из массива или пустой массив возвращает 422 и не создаёт ничего.

Неверная строка пропускается, а остальные сохраняются?

Нет. Один неверный элемент отклоняет весь пакет. Ничего не создаётся. Исправьте строку и отправьте массив снова.

Можно ли вызвать это из таблицы?

Да. Экспортируйте CSV со строкой заголовка и отправьте его методом POST как text/csv. Ответный CSV перечисляет id и url каждой строки по порядку.

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

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

Сравнения

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

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