Статьи
POST /api/v1/screenshots/bulk принимает массив JSON или тело CSV. Каждый элемент использует те же поля, что и одиночное создание. Ответ сохраняет этот порядок. Неверный элемент или пустой массив возвращает 422 и не создаёт ничего.
Тело — массив JSON не более чем из 50 объектов. url обязателен в каждом объекте, если этот объект не отправляет html или markdown. file_type задаёт format. width и height задают viewport_width и viewport_height. Если заданы и короткое имя, и полное поле, используется полное поле. fresh со значением true снимает заново. fresh со значением false включает кэш, если cache ещё не задан.
Отправьте 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.