Интерфейс используется для добавления новых сайтов или изменения настроек уже существующих сайтов. Наглядный пример использования этого интерфейса вы можете наблюдать на странице вашего аккаунта http://go.jetswap.com/account?mode=url&cmd=edit - все параметры, за исключением обязательных для API, используются точно такие же.
Для использования этого интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Помимо обязательных параметров, нужно передать следующие параметры:
Action: http://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[]='http://yandex.ru' укажет URL сайта с ID 123, второй sites[]='http://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 - опция включена
| 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 | Нет | Реферер по заказу. Один реферер на одной строке.
| 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". Только в этом режиме работает презентация, поэтому галочка автоматически включена.
- 1 - описание примечания 1 (содержимое зависит от номера примечания)
- 2 - описание примечания 2 (содержимое зависит от номера примечания)
| 2 | Замечания о изменениях в настройках сайтов в результате применения автоматических фильтров.
- 0 - тип сработавшего фильтра. Может быть:
- 1 - На вашем сайте обнаружено следующее содержимое: (2)(0). Данное содержимое нарушает правила системы, отмеченные (2)(1), поэтому соответствующая опция включена в настройках показа сайта. Это может повлиять на стоимость показа сайта, вы можете уточнить новую стоимость в настройках сайта, которые можно вызвать из списка сайтов. Если соответствующие настройки уже были включены, то изменений стоимости показа не последует.
- Вы рекламируете (2)(0). Данный сайт нарушает правила системы, отмеченные (2)(1), поэтому соответствующая опция включена в настройках показа сайта. Это может повлиять на стоимость показа сайта, вы можете уточнить новую стоимость в настройках сайта, которые можно вызвать из списка сайтов. Если соответствующие настройки уже были включены, то изменений стоимости показа не последует.
- 1 - ID сайта, к которому относится примечание.
- 2 - состоит из двух параметров, разделенных символами !=%=!. Первый параметр означает тип содержимого или URL, на который сработал фильтр, второй параметр - номер нарушения от * до ***** (см. правила системы)
|
Исчерпывающий пример вы можете получить таким образом:
- Добавьте API-интерфейс и разрешите ему выполнение операций с настройками сайтов, если это еще не было сделано ранее.
- В списке сайтов выберите один или несколько сайтов и нажмите значок "Изменить", либо нажмите ссылку Добавить сайт, если у вас еще нет сайтов в списке.
- Введите некоторые настройки в форму. В разделе "Опции" настроек сайта отметьте галочку "Выдать код API - не сохранять настройки сейчас."
- Вместо фактического сохранения введенных настроек вам будет выдан PHP-код, при вызове которого будут сохранены те настройки, которые вы ввели в форму.
|