Интерфейс используется для получения настроек уже добавленного сайта. Большинство параметров, выдаваемых интерфейсом, являются аналогичными параметрам, используемым интерфейсом добавления или изменения настроек.
Для использования этого интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Помимо обязательных параметров, нужно передать следующие параметры:
Action: http://go.jetswap.com/api
Method: POST
PAY_ACTION: set
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
fill | Да | ID сайта, для которого требуется получить настройки.
|
Ответ: передается в формате URL Encoded массив, содержащем следующие данные (индексы массива):
Параметр |
Описание |
URL | URL сайта.
| pkt | Время показа. Вычисляется как время(сек)=pkt*15. Минимальное значение 2 соответствует 30 секундам (2*15=30). Максимальное значение 20 соответствует 5 минутам.
| 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 - опция включена
| 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 - общая папка.
| geo | Геотаргетинг
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| ggeo при geo=1 | Геотаргетинг по миру. Содержит ID стран, подходящих для геотаргетинга, разделенные двоеточием. Для получения ID стран загрузите файл http://go.jetswap.com/geostat-an.txt, переименуйте в php-файл и разместите его на вашем сайте. При включении его функцией include вы получите массивы gipc, gipn, gipi, элементы с одинаковыми номерами которых содержат соответственно количество уникальных IP за неделю из определенной страны, название этой страны, ID страны для передачи в интерфейс. Например, значение 90:125:214 будет соответствовать странам Afghanistan, Aland Islands, Andorra.
| rgeo при geo=1 | Геотаргетинг по России. Содержит ID городов или иных федеральных образований, подходящих для геотаргетинга, разделенные двоеточием. Для получения ID загрузите файл http://go.jetswap.com/geostat-an.txt, переименуйте в php-файл и разместите его на вашем сайте. При включении его функцией include вы получите массивы ripc, ript, ripn, ripi, элементы с одинаковыми номерами которых содержат соответственно количество уникальных IP за неделю из определенной области, округа или города, уровень фед. образования (2 - фед. округ, 1 - регион, 0 - город/поселение),
название этого фед. образования, ID для передачи в интерфейс. Например, значение 9:20:312 будет соответствовать Приволжскому округу, Свердловской области, г. Салехард.
| cref | Реферер по заказу. Один реферер на одной строке.
| hsf | Скрытый серфинг
- 0 - не показывать сайт в скрытом серфинге
- 1 - разрешить показ сайта в скрытом серфинге
- 2 - показывать сайт только в скрытом серфинге
| prs | Режим презентации
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| pst | Параметры режима презентации, разделенные двоеточием, например: 10:1:1:2:1:0:1
Состоят из значений следующих параметров:
- prstime - время показа первого сайта презентации
- prstime1 - случайное отклонение от заданного времени
- prsmin - минимум страниц для просмотра презентации
- prsmax - максимум страниц для просмотра презентации
- prsref - режим передачи реферера
- 0 - Передавать реферер по заказу на каждую страницу (по умолчанию)
- 1 - Передавать реферер по заказу на первую страницу, на остальные - текущую страницу в браузере как реферер
- 2 - Передавать реферер по заказу на первую страницу, на остальные - предыдущую заданную вами страницу как реферер
- prstime2 - завершать показ раньше общего времени показа, случайно до 14 сек.
- prsrnd - случайный порядок показа страниц
| 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-кода"
|