Интерфейс используется для добавления новых сайтов или изменения настроек уже существующих сайтов. Наглядный пример использования этого интерфейса вы можете наблюдать на странице вашего аккаунта http://go.jetswap.com/account?mode=url&cmd=edit - все параметры, за исключением обязательных для API, используются точно такие же.
Для использования этого интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Помимо обязательных параметров, нужно передать следующие параметры:
Action: https://go.jetswap.com/api
Method: POST
PAY_ACTION: edit
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
idst | Нет | Если не задан, выполняется операция добавления сайтов.
Если задан, выполняется операция изменения сайтов. Содержит ID сайтов, разделенные двоеточием, например 123:234:456
| sites или sites[] | Да | Если производится добавление сайтов, применяется параметр sites, содержащий адреса добавляемых сайтов, каждый адрес на новой строке.
Если выполняется изменение сайтов, используется многократно в виде sites[], содержащего URL для каждого ID сайта, указанного в параметре idst. Например, если idst имеет вид 123:234, то первый параметр sites[]='https://yandex.ru' укажет URL сайта с ID 123, второй sites[]='https://google.ru' - URL для сайта с ID 234. Подробнее см. в примере ниже.
| pkm | Нет | Количество показов в день
- отрицательное число - не показывать сайт
- 0 (ноль) - отсутствие ограничений показов
- положительное число - ограничение
| pkh | Нет | Количество показов в час
- отрицательное число - не показывать сайт
- 0 (ноль) - отсутствие ограничений показов
- положительное число - ограничение
| pkt, pkt2 | Да | Минимальное и максимальное время показа в секундах. Реальное время показа будет выбрано случайным образом в интервале между минимальным и максимальным временем. Допустимое минимальное время показа - 30 секунд, допустимое максимальное - 900 секунд. Максимальное время pkt2 не обязательно должно быть задано, в этом случае время показа сайта будет всегда фиксированным.
| msf | Нет | Ручной серфинг
- 0 - показывать сайт во всех видах серфинга (в том числе и в ручном)
- 1 - показывать сайт только в ручном серфинге.
| hsf | Нет | Скрытый серфинг
- 0 - не показывать сайт в скрытом серфинге
- 1 - разрешить показ сайта в скрытом серфинге
- 2 - показывать сайт только в скрытом серфинге
| ipex | Нет | Эксклюзивные IP-адреса.
- 0 - функция отключена
- 1-15 - номер посещения с эксклюзивного IP. (1-первое посещение, т.е. ранее в течение 48 часов посещений с этого IP не было).
| tml1 | Нет | Минимальный интервал между показами.
- 0 (ноль) - отсутствие интервала
- положительное число - интервал
| tml2 | Нет | Максимальный интервал между показами.
- 0 (ноль) - отсутствие интервала
- положительное число - интервал
| tmlrefresh | Нет | Обновить интервал между показами
- 0 - не обновлять (будут обновлены границы интервала, сам интервал будет обновлен при следующем показе сайта)
- 1 - обновить интервал с учетом новых границ
| 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 - опция включена
| 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 | Нет | Имя сайта (отображается в списке сайтов)
| newfolder | Нет | Имя новой папки сайта (применяется только при создании новой папки)
| fid | Нет | ID папки сайта. 0 - общая папка.
| speed | Нет | Минимальная скорость загрузки страниц у посетителей
- 0 - опция отключена (по умолчанию)
- 0.1 - 25.5 - значение скорости (Мбит/сек)
| highspeed | Нет | Минимальная скорость загрузки больших файлов у посетителей
- 0 - опция отключена (по умолчанию)
- 0.1 - 25.5 - значение скорости (Мбит/сек)
| geo | Да | Геотаргетинг
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| geoset[] | Нет | Массив элементов геотаргетинга, принимает идентификаторы выбранных объектов (стран, областей, городов), из которых разрешены посещения сайта. Массив вида geoset[]=ObjectID, где ObjectID - ID разрешенного объекта геотаргетинга. Формат базы данных идентификаторов можно найти на странице интерфейса geodb
| geolimit | Нет | Контроль процента распределения геотаргетинга (подробное описание работы по ссылке)
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| geolimitmin | Нет | Минимальный порог показов каждый час, при котором не используется контроль распределения геотаргетинга. Нужен, чтобы при отсутствии нужных объектов геотаргетинга все равно осуществлялись показы.
| geolimitprc | Нет | Процент точности контроля распределения IP посетителей по заданным объектам геотаргетинга. Принимает значение от 1 до 500, значение в процентах.
| geolimits[] | Нет | Массив элементов геотаргетинга, при включенной настройке geolimit=1. Имеет формат geolimits[ObjectID]=Limit, где ObjectID - ID объекта геотаргетинга(страны, города, области), Limit - приоритет получения трафика с данного объекта, от 1 до 100. Процент приоритета каждого объекта вычисляется исходя из суммы приоритетов всех объектов. Формат базы данных идентификаторов можно найти на странице интерфейса geodb
| cref | Нет | Реферер по заказу. Один реферер на одной строке.
| prs | Нет | Режим презентации
- 0 - опция отключена (по умолчанию)
- 1 - показ страниц одного сайта
- 2 - показ страниц разных сайтов
- 3 - динамическая презентация
| prstime | Нет | Время показа первого сайта презентации
| prstime1 | Нет | Случайное отклонение от заданного времени
| prsmin | Нет | Минимум страниц для просмотра презентации
| prsmax | Нет | Максимум страниц для просмотра презентации
| prsref | Нет | Режим передачи реферера
- 0 - Передавать реферер по заказу на каждую страницу (по умолчанию)
- 1 - Передавать реферер по заказу на первую страницу, на остальные - текущую страницу в браузере как реферер
- 2 - Передавать реферер по заказу на первую страницу, на остальные - предыдущую заданную вами страницу как реферер
| prstime2 | Нет | Завершать показ раньше общего времени показа, случайно до 14 сек.
| prsrnd | Нет | Случайный порядок показа страниц
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| mouse | Нет | Разрешить использование мыши
- 0 - опция отключена (по умолчанию)
- 1 - опция включена
| prtab | Нет | Количество дополнительных вкладок браузера (от 0 до 3)
| tms[] | Да при prs=1 | Время показа команды презентации, передается для каждой команды презентации.
| cmds[] | Да при prs=1 | Команда презентации
- 0 - Переход
- 1 - Поиск ссылки
- 2 - Ввод текста
- 3 - Отметить флажок
- 4 - Отправить форму
- 5 - Отправить событие
- 6 - Очистить Cookies
- 7 - Вставить скрипт
- 8 - Переход POST
- 9 - Повысить привилегии
| urls[] | Да при prs=1 | Параметры команды презентации
| 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 Encoded массив, содержащим следующие данные (индексы массива):
Параметр |
Описание |
0 | Массив, содержащий описания ошибок. Если имеет хотя бы один элемент, операция не была выполнена успешно. Каждый элемент этого массива содержит следующие индексы:
- 0 - номер ошибки. Может быть:
- 1 - внутренняя ошибка.
- 2 - для сайта с ID, переданным в элементе 1 массива (1), не задан адрес сайта.
- 3 - для сайта с номером (1) не задан адрес сайта.
- 4 - адрес сайта с ID (1) и URL (2) должен начинаться с http или https.
- 5 - адрес сайта с номером (1) и URL (2) должен начинаться с http или https.
- 6 - URL (1) находится в черном списке.
- 7 - За один раз можно редактировать не более 100 сайтов
- 8 - За один раз можно добавлять не более 25 сайтов.
- 9 - Не введен адрес сайта
- 10 - Использование мыши недоступно в скрытом режиме
- 1 - описание ошибки 1 (содержимое зависит от номера ошибки)
- 2 - описание ошибки 2 (содержимое зависит от номера ошибки)
| 1 | Массив, содержащий замечания по переданным настройкам сайта. Не является индикатором успеха или неудачи выполнения операции.
- 0 - номер примечания. Может быть:
- 1 - Ваш сайт показывается всего 15 секунд. Этого может быть недостаточно, чтобы счетчики успели загрузиться и засчитать показ. Мы рекомендуем вам установить как минимум 30 секунд показа. Прочитайте также дополнительные рекомендации. (в данный момент не используется)
- 2 - Ваш сайт показывается без учета уникальности посетителей. Это низкоприоритетный показ. Также часть посещений может быть незасчитана счетчиками. Рекомендуем вам включить контроль уникальности посетителей в настройках сайта. Прочитайте также дополнительные рекомендации.
- 3 - Презентация на вашем сайте использует JavaScript-вставки, поэтому ваш сайт автоматически помечен галочкой ***как потенциально опасный. Вставка JavaScript должна использоваться только для управления показом сайта, запрещается создавать дополнительные элементы на сайте! Подробнее. (в данный момент не используется)
- 4 - Вы ввели настройки, запрещающие показ вашего сайта. С отрицательными настройками количества показов в день или в час ваш сайт не будет показываться.
- 5 - Вы ввели ограничение на (1) показов сайта в день. Это небольшое количество показов. Если вам его не будет хватать, увеличьте это ограничение в настройках.
- 6 - Вы отметили использование геотаргетинга, но не отметили галочку «Показывать сайт только уникальным посетителям». Такое сочетание настроек блокирует показ вашего сайта, поэтому галочка «Показывать сайт только уникальным посетителям» автоматически включена
- 7 - Показ сайта только в ручном серфинге не совместим со скрытым показом сайта, поэтому ваш сайт не будет показываться.
- 8 - Вы разрешили показ сайта в скрытом режиме, однако использование мыши в этом режиме недоступно, при показе сайта в этом режиме будет использован обычный режим эмуляции мыши.
- 9 - Вы включили режим презентации, но не отметили галочку "Показ сайта только в SafeSurf". Только в этом режиме работает презентация, поэтому галочка автоматически включена.
- 10 - Вы включили геотаргетинг, но не выбрали ни одного элемента (страны, города, области), из которых вы хотите получать трафик, поэтому автоматически включена галочка "Все страны (приоритет трафика)", чтобы ваш сайт показывался при такой настройке, это дает приоритет показа перед другими сайтами, но влияет на стоимость показа.
- 11 - Вы включили геотаргетинг, при этом одновременно выбрали элемент "Все страны (приоритет показа)" и другие элементы (страны, области, города), поэтому элемент "Все страны" был автоматически отключен, иначе геотаргетинг работать не будет - вы будете получать посетителей со всех стран.
- 1 - описание примечания 1 (содержимое зависит от номера примечания)
- 2 - описание примечания 2 (содержимое зависит от номера примечания)
| 2 | Замечания о изменениях в настройках сайтов в результате применения автоматических фильтров.
- 0 - тип сработавшего фильтра. Может быть:
- 1 - На вашем сайте обнаружено следующее содержимое: (2)(0). Данное содержимое нарушает правила системы, отмеченные (2)(1), поэтому соответствующая опция включена в настройках показа сайта. Это может повлиять на стоимость показа сайта, вы можете уточнить новую стоимость в настройках сайта, которые можно вызвать из списка сайтов. Если соответствующие настройки уже были включены, то изменений стоимости показа не последует.
- Вы рекламируете (2)(0). Данный сайт нарушает правила системы, отмеченные (2)(1), поэтому соответствующая опция включена в настройках показа сайта. Это может повлиять на стоимость показа сайта, вы можете уточнить новую стоимость в настройках сайта, которые можно вызвать из списка сайтов. Если соответствующие настройки уже были включены, то изменений стоимости показа не последует.
- 1 - ID сайта, к которому относится примечание.
- 2 - состоит из двух параметров, разделенных символами !=%=!. Первый параметр означает тип содержимого или URL, на который сработал фильтр, второй параметр - номер нарушения от * до ***** (см. правила системы)
|
Исчерпывающий пример вы можете получить таким образом:
- Добавьте API-интерфейс и разрешите ему выполнение операций с настройками сайтов, если это еще не было сделано ранее.
- В списке сайтов выберите один или несколько сайтов и нажмите значок "Изменить", либо нажмите ссылку Добавить сайт, если у вас еще нет сайтов в списке.
- Введите некоторые настройки в форму. В разделе "Опции" настроек сайта отметьте галочку "Выдать код API - не сохранять настройки сейчас."
- Вместо фактического сохранения введенных настроек вам будет выдан PHP-код, при вызове которого будут сохранены те настройки, которые вы ввели в форму.
|