Skip to main content

Начало работы

Синхронный скриншот

Эндпоинт screenshot запускает сессию браузера и возвращает изображение в base64 в JSON — идеально для программных интеграций и API Tester.

Асинхронные задачи

Эндпоинты jobs ставят задачи скриншота в очередь и позволяют опрашивать статус и результаты — идеально для высокой нагрузки или медленных страниц.

REST-архитектура

API скриншотов сайтов следует принципам REST с предсказуемыми URL, ориентированными на ресурсы, и стандартными HTTP-кодами состояния для бесшовной интеграции и обработки ошибок.

Безопасность HTTPS

Вся коммуникация с API защищена TLS 1.2 или выше для обеспечения целостности и конфиденциальности данных.

Версии API

API скриншотов сайтов поддерживает обратную совместимость через версионирование и сейчас работает в Version 1.

Аутентификация

Ваш API-ключ — единственные учётные данные для доступа к API скриншотов сайтов. Каждый сервис Cleariflow требует отдельного ключа. Передавайте ключ в JSON-теле как api_key или как query-параметр для legacy GET-эндпоинта.

Базовый URL

Рендеринг страниц

Страницы рендерятся в реальном headless-браузере. JavaScript полностью выполняется перед захватом скриншота. Встроенная SSRF-защита блокирует запросы к localhost и частным IP-диапазонам.

Коды ответов и ошибок

При неудаче API возвращает структурированные JSON-ответы с конкретными кодами и описаниями для эффективного устранения неполадок.