Один GET-запрос — один скриншот. Ключ передаётся в заголовке X-API-Key.
GET https://snapapi.ru/screenshot?url=example.com&full_screen=true&format=png
заголовок: X-API-Key: snap_ваш_ключ
curl -H "X-API-Key: snap_ваш_ключ" \ "https://snapapi.ru/screenshot?url=example.com&full_screen=true"
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| url | string | — | обязательный, адрес страницы для снимка |
| width | int | 1920 | ширина окна браузера, px |
| height | int | 1080 | высота окна браузера, px |
| full_screen | bool | false | снимок всей прокручиваемой страницы, а не только окна |
| format | string | png | формат изображения: png, jpeg, webp |
| timeout | int | 30 | таймаут загрузки страницы, сек |
| delay | int | 0 | задержка перед снимком (ждём анимации/загрузку), мс |
| cache | int | 300 | сколько секунд отдавать закешированный снимок вместо нового |
| crop | string | — | обрезка в формате x,y,width,height |
| Заголовок | Значение |
|---|---|
| Content-Type | image/png, image/jpeg или image/webp — по format |
| Content-Length | размер изображения в байтах |
| X-Screenshot-Width | фактическая ширина снимка, px |
| X-Screenshot-Height | фактическая высота снимка, px |
| X-Screenshot-Cached | true/false — снимок отдан из кеша |
| Код | Когда |
|---|---|
| 401 | заголовок X-API-Key отсутствует или ключ невалиден |
| 429 | превышен лимит запросов тарифного плана |
Нужно больше снимков в месяц или мониторинг изменений страниц — смотрите тарифы.