API и документация
Для создания скриншота сайта достаточно одного парамета - его адреса.
http://get.thumbshots.ru/?url=адрес страницы
http://get.thumbshots.ru/?url=http://mail.ru
Схему HTTP указывать не обязательно
http://get.thumbshots.ru/?url=mail.ru
Ниже приведены используемые параметры и их значения, вы также можете сразу перейти к примерам запросов. Параметры запроса можно комбинировать в любом сочетании и порядке.
Используемые параметры
| Параметр | Значение | Без регистрации | После регистрации | Описание |
|---|---|---|---|---|
| key | [0-9a-z]{32} | не требуется | 32-x символьный идентификатор пользователя, выдающийся при регистрации. Ключ должен присутствовать в каждом запросе. | |
| url | URL адрес | URL адрес страницы или сайта по протоколу HTTP. Допускаются закодированные адреса. | ||
| w | 24 - 1280 | Ширина тамбшота в пикселях 0 - ширина по умолчанию |
||
| h | 18 - 32000 | Высота тамбшота в пикселях 0 - без ограничения высоты |
||
| refresh | 0 - 1 | Запрос обновления тамбшота | ||
| lang | RU, EN | Язык вывода системных сообщений и ошибок. | ||
| v | 0 - 1 | Параметр определяет режим вывода информационных сообщений и ошибок 0 - простые сообщения 1 - детальные сообщения с кодом ошибок |
||
| size | XS, S, M, L, XL, XXL, XXXL, XXXXL |
XS, S, M, L |
Размер скриншота
|
|
| type | img, embed, xml, json |
img, embed | Тип вывода результата
<img src="{адрес}" alt="{URL}" title="{URL}" /> |
* Скриншоты главной страницы домена второго и третьего уровней.
Например, при запросе страницы http://sub.domain.ru/page/1.html будет показан снимок с http://sub.domain.ru
Примеры запросов скриншотов
- Скриншот размером 120x90 пикселей (размер по умолчанию)
http://get.thumbshots.ru/?url=адрес страницы - Пример запроса с ключем (для зарегистрированных пользователей)
http://get.thumbshots.ru/?key=PR2QSAB614K8DR25WBN5UYT4472IXL0W&url=адрес страницы - Скриншот размером 320x240 пикселей
http://get.thumbshots.ru/?url=адрес страницы&size=L - Тег
с картинкой размером 150x120 пикселей
http://get.thumbshots.ru/?url=адрес страницы&size=M&type=embed - Полноразмерный скриншот страницы шириной 320 пикселей (и полной высотой)
http://get.thumbshots.ru/?url=адрес страницы&w=320 - Скриншот страницы шириной 320 пикселей и высотой 100 пикселей
http://get.thumbshots.ru/?url=адрес страницы&w=320&h=100 - Запрос обновления скриншота
http://get.thumbshots.ru/?url=адрес страницы&refresh=1 Комбинирование параметров размера скриншота.
При использовании в запросе и параметра size и параметров w или h, предпочтение отдается параметрам w и h. По приведенному запросу будет показан скриншот размером 700x500http://get.thumbshots.ru/?url=адрес страницы&w=700&h=500&size=L
