Интерфейс используется для получения настроек уже добавленного сайта. Большинство параметров, выдаваемых интерфейсом, являются аналогичными параметрам, используемым интерфейсом добавления или изменения настроек.
Для использования этого интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Помимо обязательных параметров, нужно передать следующие параметры:
Action: https://go.jetswap.com/api
Method: POST
PAY_ACTION: set
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
fill | Да | ID сайта, для которого требуется получить настройки.
|
Ответ: передается в формате URL Encoded массив, содержащем следующие данные (индексы массива):
Параметр |
Описание |
URL | URL сайта.
| pkt, pkt2 | Минимальное и максимальное время показа в секундах. Реальное время показа будет выбрано случайным образом в интервале между минимальным и максимальным временем. Допустимое минимальное время показа - 30 секунд, допустимое максимальное - 900 секунд. Максимальное время pkt2 не обязательно должно быть задано, в этом случае время показа сайта будет всегда фиксированным.
| pkm | Количество показов в день
- отрицательное число - не показывать сайт
- 0 (ноль) - отсутствие ограничений показов
- положительное число - ограничение
| pkh | Количество показов в час
- отрицательное число - не показывать сайт
- 0 (ноль) - отсутствие ограничений показов
- положительное число - ограничение
| tml | Интервал между показами (без учета значений tmlc1/tmlc2).
- 0 (ноль) - отсутствие интервала
- положительное число - интервал
| tml1 | Минимальный интервал между показами.
- 0 (ноль) - отсутствие интервала
- положительное число - интервал
| tml2 | Максимальный интервал между показами.
- 0 (ноль) - отсутствие интервала
- положительное число - интервал
| tmlс1 | Плавное изменение нижней границы интервала (tml1) в течение часа. Реально нижняя граница интервала будет равна tml1 + MINUTE/60*tmlc1, где MINUTE - минута часа.
- 0 (ноль) - отсутствие изменения
- положительное число - увеличение интервала tml1
- отрицательное число - уменьшение интервала tml1
| tmlс2 | Плавное изменение верхней границы интервала (tml2) в течение часа. Реально верхняя граница интервала будет равна tml2 + MINUTE/60*tmlc2, где MINUTE - минута часа.
- 0 (ноль) - отсутствие изменения
- положительное число - увеличение интервала tml2
- отрицательное число - уменьшение интервала tml2
| ssf | Показывать сайт только в SafeSurf
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| ipc | Контроль уникальности посетителей
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| msf | Ручной серфинг
- 0 - сайт показывается во всех видах серфинга (в том числе и в ручном)
- 1 - сайт показывается только в ручном серфинге.
| ipex | Эксклюзивные IP-адреса.
- 0 - функция отключена
- 1-15 - номер посещения с эксклюзивного IP. (1-первое посещение, т.е. ранее в течение 48 часов посещений с этого IP не было).
| second | Не показывать сайт посетителям с близкими IP-адресами.
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| proxy | Фильтрация посетителей с прокси-серверов.
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| li | Фильтрация посетителей, не учитываемых статистикой LiveInternet.
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| exact | Точное соблюдение лимитов показов
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| iphl | Время уникальности IP-адресов, мин. значение.
| iph | Время уникальности IP-адресов, макс. значение.
| dayunick | Посуточная уникальность IP-адресов, отклонение от времени сервера(московского времени)
- 0 - опция отключена (по умолчанию)
- 24 - опция включена, нет отклонения от времени сервера.
от -23 до 23, исключая 0 - опция включена, отклонение от времени сервера.
dontstop | Не останавливать показы сайта при его неработоспособности
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| hideref | Скрытие HTTP_REFERER
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| uh | Скрывать URL сайта
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| name | Имя сайта (отображается в списке сайтов)
| fid | ID папки сайта. 0 - общая папка.
| speed | Минимальная скорость загрузки страниц у посетителей
- 0 - опция отключена (по умолчанию)
- 0.1 - 25.5 - значение скорости (Мбит/сек)
| highspeed | Минимальная скорость загрузки больших файлов у посетителей
- 0 - опция отключена (по умолчанию)
- 0.1 - 25.5 - значение скорости (Мбит/сек)
| geo | Геотаргетинг
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| geoset[] | Массив элементов геотаргетинга, принимает идентификаторы выбранных объектов (стран, областей, городов), из которых разрешены посещения сайта. Формат базы данных идентификаторов можно найти на странице интерфейса geodb
| geolimit | Контроль процента распределения геотаргетинга (подробное описание работы по ссылке)
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| geolimitmin | Минимальный порог показов каждый час, при котором не используется контроль распределения геотаргетинга. Нужен, чтобы при отсутствии нужных объектов геотаргетинга все равно осуществлялись показы.
| geolimitprc | Процент точности контроля распределения IP посетителей по заданным объектам геотаргетинга. Принимает значение от 1 до 500, значение в процентах.
| geolimits[] | Массив элементов геотаргетинга, при включенной настройке geolimit=1. Имеет формат geolimits[ObjectID]=Limit, где ObjectID - ID объекта геотаргетинга(страны, города, области), Limit - приоритет получения трафика с данного объекта, от 1 до 100. Процент приоритета каждого объекта вычисляется исходя из суммы приоритетов всех объектов. Формат базы данных идентификаторов можно найти на странице интерфейса geodb
| cref | Реферер по заказу. Один реферер на одной строке.
| hsf | Скрытый серфинг
- 0 - не показывать сайт в скрытом серфинге
- 1 - разрешить показ сайта в скрытом серфинге
- 2 - показывать сайт только в скрытом серфинге
| prs | Режим презентации
| pst | Параметры режима презентации, разделенные двоеточием, например: 10:1:1:2:1:0:1
Состоят из значений следующих параметров:
- prstime - время показа первого сайта презентации
- prstime1 - случайное отклонение от заданного времени
- prsmin - минимум страниц для просмотра презентации
- prsmax - максимум страниц для просмотра презентации
- prsref - режим передачи реферера
- 0 - Передавать реферер по заказу на каждую страницу (по умолчанию)
- 1 - Передавать реферер по заказу на первую страницу, на остальные - текущую страницу в браузере как реферер
- 2 - Передавать реферер по заказу на первую страницу, на остальные - предыдущую заданную вами страницу как реферер
- prstime2 - завершать показ раньше общего времени показа, случайно до 14 сек.
- prsrnd - случайный порядок показа страниц
| prtab | Количество дополнительных вкладок браузера в режиме презентации (от 0 до 3).
| mouse | Разрешить использование мыши
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| ptm | Время показа команд презентации, для каждой команды соединяется двоеточием. Например, 30:15 означает 30 секунд для первой команды и 15 секунд для второй.
| pac | Команды презентации, разделенные символом двоеточие. Для каждой команды:
- 0 или пусто - Переход
- 1 - Поиск ссылки
- 2 - Ввод текста
- 3 - Отметить флажок
- 4 - Отправить форму
- 5 - Отправить событие
- 6 - Очистить Cookies
- 7 - Вставить скрипт
- 8 - Переход POST
- 9 - Повысить привилегии
| purl | Параметры команд презентации, разделенные символами <!;#D>
| addcat | Добавить в каталог сайтов
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| sitetitle при addcat=1 | Название сайта для каталога сайтов
| sitedesk при addcat=1 | Описание сайта для каталога сайтов
| catid при addcat=1 | Тематика сайта для каталога сайтов. Для получения ID тематики сайта скопируйте файл http://list.jetswap.com/catlist.txt на ваш сервер, первая строчка имеет ID - 0, вторая - 1 и т.д.
| v2 при наличии нарушений | Нарушение пунктов ** Правил системы
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| v3 при наличии нарушений | Нарушение пунктов *** Правил системы
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| v4 при наличии нарушений | Нарушение пунктов **** Правил системы
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| v5 при наличии нарушений | Нарушение пунктов ***** Правил системы
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| остальные поля | сервером могут передаваться также и другие служебные поля, не имеющие значения, либо использующиеся в других интерфейсах.
| |
Пример: сервером может быть выдан например ответ !url=http%3A%2F%2Fjetswap.com&pkt=4&free=0&nofree=0&hideref=1&crmin=0&vipmin=0&cradd=0&vipadd=0&cref=http%3A%2F%2Fya.ru&lc=0&chk=1277315236&geonac=1.3&uh=1&iph=24&iphl=0&fid=0&name=jetswap&ipc=1&pkm=100&pkh=5&ssf=1&v2=1&v3=1&v4=1&v5=1&tml=20&prs=1&hsf=0&geo=1&second=1&pst=10%3A1%3A1%3A2%3A1%3A0%3A1&ptm=%3A&pac=%3A&purl=r.htm%3C%21%3B%23D%3Efull.htm&rgeo=0&ggeo=1%3A170&site=http%3A%2F%2Fjetswap.com&sites[0]=http%3A%2F%2Fjetswap.com
После устранения ! перед ответом и обработки текста ответа функцией php parse_str выходной массив примет вид:
Array
(
[url] => http://jetswap.com
[pkt] => 4
[free] => 0
[nofree] => 0
[hideref] => 1
[crmin] => 0
[vipmin] => 0
[cradd] => 0
[vipadd] => 0
[cref] => http://ya.ru
[lc] => 0
[chk] => 1277315236
[geonac] => 1.3
[uh] => 1
[iph] => 24
[iphl] => 0
[fid] => 0
[name] => jetswap
[ipc] => 1
[pkm] => 100
[pkh] => 5
[ssf] => 1
[v2] => 1
[v3] => 1
[v4] => 1
[v5] => 1
[tml] => 20
[prs] => 1
[hsf] => 0
[geo] => 1
[second] => 1
[pst] => 10:1:1:2:1:0:1
[ptm] => :
[pac] => :
[purl] => r.htmfull.htm
[rgeo] => 0
[ggeo] => 1:170
[site] => http://jetswap.com
[sites] => Array
(
[0] => http://jetswap.com
)
)
Готовая функция для этого интерфейса на языке PHP доступна в списке API-интерфейсов при нажатии на значок "Пример PHP-кода"
|