Скриншоты

Статусы задач

Продолжайте опрос статуса (polling) для PENDING и IN_PROGRESS. DONE и ERROR завершают задачу.

Модель статусов

`PENDING`

Задача сохранена и ждёт обработки. Сохраните taskId и проверьте статус позже; создавать новую задачу из-за ожидания не нужно.

`IN_PROGRESS`

Воркер начал создавать скриншот. Продолжайте опрос статуса, делая паузу между запросами.

`DONE`

Задача успешно завершена. Скачайте результат из resultUrl, если ссылка доступна, и остановите опрос. payloadSize содержит размер, если он известен.

`ERROR`

Задача завершилась ошибкой. resultUrl равен null, а errorMessage может содержать описание ошибки. Остановите опрос; новый запрос создаст новую задачу и снова расходует квоту.

Переходы

text

PENDING -> IN_PROGRESS
PENDING -> DONE
PENDING -> ERROR
IN_PROGRESS -> DONE
IN_PROGRESS -> ERROR

Когда повторять запрос

Сохраните taskId и запрашивайте GET /v1/screenshots/{taskId}, пока задача не перейдёт в DONE или ERROR. Делайте паузу между запросами статуса — не отправляйте их в непрерывном цикле.

На PAID можно добавить timeoutSeconds от 1 до 60. Сервер ждёт, пока задача перейдёт в DONE или ERROR либо истечёт timeoutSeconds, и в любом случае возвращает JSON со статусом и HTTP 200.

Этот запрос отличается от POST /take: /take может вернуть бинарное изображение или JSON с HTTP 202. Обычный статусный запрос не возвращает изображение в теле ответа.

Поля ответа

Поле	Значение
`taskId`	UUID задачи. Сохраните его до завершения обработки.
`status`	PENDING, IN_PROGRESS, DONE или ERROR.
`resultUrl`	Временная ссылка на результат для DONE; иначе null.
`errorMessage`	Описание ошибки, если оно доступно.
`payloadSize`	Размер результата в байтах, если он известен.
`waitUntil`	Выбранный режим навигации: load, domcontentloaded, networkidle или null для автоматического совместимого режима.
`delayMs`	Фактически использованная дополнительная задержка в миллисекундах.
`waitForSelector`	CSS-селектор ожидания или null, если ожидание элемента не задано.
`selector`	CSS-селектор снятого элемента или null для снимка страницы либо видимой области.
`createdAt`	Время создания задачи.
`updatedAt`	Время последнего обновления задачи.

Полный сценарий создания задачи описан в руководстве по асинхронному API. Вариант с изображением в том же запросе — в руководстве по синхронному API.