главнаяконтактыреклама
JetSwap — система раскрутки сайтов
РегистрацияО системеАккаунтСтатистикаХостингДомены ru от 90 рублей
 

Интерфейсы управления рекламой сайтов

Автоматические интерфейсы JetSwap позволяют полностью управлять рекламой сайта в сервисе активной рекламы: добавлять новые сайты, редактировать настройки уже существующих сайтов, управлять расписанием показов, пополнять счет сайтов кредитами и VIP-показами. Это дает возможность создать множество полезных функций, начиная от обновления настроек по заданному вами расписанию и заканчивая собственным сервисом для рекламодателей на базе JetSwap!
  • Рекомендации по использованию интерфейсов
Обращаем внимание, что при использовании данных интерфейсов (или в принципе любых страниц сайта JetSwap) в случае автоматизированного обращения к ним с одними и теми же параметрами бессмысленно часто, в течение продолжительного времени (чаще 1 раза в минуту) мы оставляем за собой право ограничить или прекратить вообще как использование интерфейсов, так и использование такими лицами всего сайта в целом. При создании паразитной нагрузки на сервер на ваш аккаунт будет наложен штраф.

При выполнении аналогичных групповых операций используйте переменную idst для указания всех сайтов в одном запросе, с которыми нужно выполнить операцию, и не используйте несколько запросов с одним указанным сайтом.

  • Включение интерфейсов
Включить интерфейсы управления рекламой сайтов вы можете в вашем аккаунте. На странице включения интерфейсов нужно отметить галочку "Управление сайтами" Подробнее процесс включения и описание настроек интерфейса описан на странице http://jetswap.com/merchant_interface.htm#2

  • Общие параметры
Для использования интерфейсов вам необходимо создать запрос по адресу обработчика и передать параметры операции. Для всех интерфейсов управления рекламой обязательно передаются следующие параметры:
Action: http://go.jetswap.com/api
Method: POST
Поля, передаваемые в форме:
Параметр
Обязательный
Описание
PAY_INTERFACEДаИнтерфейс, который используется для проведения платежа. Может принимать значение только 5 (цифра пять)
PAY_APIДаID API-интерфейса, отображается в списке интерфейсов в первой колонке.
PAY_ACTIONДаВыполняемая операция. В зависимости от принимаемых значений требуется передача дополнительных параметров (описаны ниже). Принимает значения:
  • edit - добавление или изменение параметров сайтов.
  • set - получение текущих параметров рекламы сайта
  • points - выполнение операций со счетом сайтов
  • cost - получение стоимости одного показа сайта (в кредитах)
  • stat - получение статистики показов сайтов и состояния счета.
  • statip - получение статистики по ip-адресам посетителей сайтов
  • delete - удалить сайты
  • task - создать/изменить расписание показов сайтов
  • taskset - получение настроек расписания показов сайта
  • taskdel - удалить расписание показов сайтов
  • prs - получить код теста презентации сайта
  • prstime - выдача информации о времени досрочной остановки презентации
  • list - получить список сайтов
  • lc - управление контролем загрузки страницы
  • startstop - приостановка/возобновление показа сайта
  • showstat - получение почасовой или дневной статистики показов сайтов
  • archive - архивация и восстановление настроек сайтов
PAY_TIMEДаВремя выполнения операции в формате UNIX Timestamp. Может отклоняться от времени сервера не более чем на 10 минут (время на сервере московское).
PAY_CODEДаЭлектронная подпись запроса (см. ниже)

После обработки запроса сервер вернет ответ:
Вариант ответа
Описание
1Интерфейс PAY_API не активен или не существует
2Код PAY_CODE неверен
3Время PAY_TIME не соответствует предъявляемым требованиям
5Переменная PAY_INTERFACE задана неверно или отсутствует
6Вызывающий IP-адрес не попадает в список разрешенных
!ОтветЗапрос к интерфейсу выполнен успешно. Форматы ответов указаны для каждой операции отдельно. Присутствие "!" не обязательно означает успешное выполнение операции, оно лишь означает успешный запрос к интерфейсу, методы оценки успешности выполнения операции описаны отдельно для каждой операции. Ответ возвращается в виде URL-Encoded массива.
Любое другоеВнутренняя ошибка сервера

Электронная подпись запроса(Параметр PAY_CODE)
Для проверки подлинности запроса используется электронная подпись, которая передается обработчику в переменной PAY_CODE. Она формируется с использованием функции md5:
PAY_CODE=md5("PAY_API::PAY_ACTION::PAY_TIME::PAY_INTERFACE::PAY_KEY")
где PAY_KEY - секретный код, который вводится при настройке интерфейса, другие переменные описаны выше в этом пункте. Символы "::" не заменяются и служат разделителями переменных.

  • Формат ответа URL-Encoded массив
В случае удачного обращения к интерфейсу сервер вернет ответ в формате !Ответ, где Ответ будет содержаться в виде массива, закодированного функцией urlencode. Чтобы разобрать ответ, удалите начальный символ ! и обработайте ответ PHP-функцией parse_str. В результате вы получите массив автоматически получите массив с ответом, пригодным для дальнейшей обработки.

Например, если переменная $Result содержит ответ сервера, то в результате применения такого кода

$Result=substr($Result,1,strlen($Result)-1);
parse_str($Result,$ResultArray);
мы получим переменную $ResultArray, содержащую обычный массив, пригодный для простой обработки. Форматы возвращаемых массивов описаны для каждой функции отдельно (см. список возможных значений PAY_ACTION)
  • Выполнение операций по временному доверию
Пользователь JetSwap может доверить вам частичное управление рекламой своих сайтов с помощью инструмента доверия. На странице http://go.jetswap.com/account?mode=url&cmd=trust пользователь отметит нужные возможности, которые он желает предоставить вам, и получит специальный код. Этот код он должен передать вам, а вы его передадите в параметре PAY_TRUST в неизменном виде, тогда вы сможете выполнять разрешенные пользователем операции от его имени. Эта функция может пригодиться при предоставлении дополнительных сервисов, не предоставляемых в данный момент интерфейсом JetSwap, например копирования настроек между пользовательскими аккаунтами или помощи пользователям в настройке. Выполняя команду по доверенности, вы можете изменять только сайты доверителя, к вашим сайтам команда доступ иметь не будет.

Вы можете заранее заготовить ссылку для пользователя с уже отмеченными нужными вам функции с помощью передачи переменной select на страницу http://go.jetswap.com/account?mode=url&cmd=trust. Переменная принимает нужные значения PAY_ACTION, разделенные двоеточием.

Например, при входе на страницу http://go.jetswap.com/account?mode=url&cmd=trust&select=list:edit будут отмечены возможности получения списка сайтов и добавления или изменения настроек сайтов.

  • Изменение любых настроек сайта по расписанию

Применение API-интерфейсов доступно не только программистам, но и обычным пользователям! С помощью API вы можете изменять настройки сайтов автоматически в заданное время, не обладая специальными знаниями.

Все предельно просто:

  • Создаете API-интерфейс
  • В списке сайтов выбираете нужные сайты и изменяете их настройки нужным образом.
  • Перед сохранением настроек отметьте галочку "Создать код для API" и нажмите кнопку "Сохранить"
  • Настройки сохранены не будут, а будет выдан PHP-код. Скопируйте этот код в файл, загрузите на хостинг, который поддерживает PHP, cURL, вызов других сайтов по HTTP, запуск скриптов по расписанию (большинство платных хостингов поддерживают эти возможности даже на минимальных тарифных планах).
  • Настройте функцию запуска загруженного вами файла по расписанию. При запуске этого файла для выбранных сайтов будут изменены настройки, которые вы ввели. Обычно такая функция на хостинге называется Cron или Crontab. В качестве команды введите php -f /путь_к_файлу_на_хостинге/имя_файла.php, предварительно узнав путь к файлу. Если что-то не работает, проконсультируйтесь у вашего хостинг-оператора.
Если какой-нибудь из этих пунктов вам непонятен, смотрите видео!

  • История изменений интерфейсов

  • 15 ноября 2018 г.
    Динамическая презентация 2.0
    • edit - параметр prs может принимать значение 3.
    • set - параметр prs может принимать значение 3.
  • 10 августа 2015 г.
    Доступна фильтрация посетителей, не учитываемых счетчиком LiveInternet
    • edit - добавлен параметр li.
    • set - добавлен параметр li.
  • 25 июля 2015 г.
    Доступна фильтрация посетителей по скорость загрузки страниц и больших файлов
    • edit - добавлены параметры speed и highspeed.
    • set - добавлены параметры speed и highspeed.
  • 29 декабря 2014 г.
    Доступны функции для работы с архивом настроек сайтов
    • archive - добавлен интерфейс archive.
  • 9 декабря 2014 г.
    Доступна почасовая и дневная статистика показов сайтов
    • showstat - добавлен интерфейс showstat.
  • 6 февраля 2014 г.
    Доступна новая функция приостановки или возобновления показов выбранных сайтов
    • startstop - добавлен интерфейс startstop.
  • 25 ноября 2012 г.
    Доступна установка галочки "Разрешить использование мыши".
    • edit - добавлен параметр mouse, ошибка 10 и предупреждение 8.
    • set - добавлен параметр mouse.
  • 27 сентября 2012 г.
    Доступна выдача информации по времени досрочной остановки презентации.
    • prstime - добавлен интерфейс prstime.
  • 6 сентября 2012 г.
    Доступна установка галочки "Точное соблюдение лимитов показов"
    • edit - добавлен параметр exact.
    • set - добавлен параметр exact.
  • 3 сентября 2012 г.
    Контроль загрузки страницы доступен для управления через API.
    • lc - добавлено управление контролем загрузки страницы.
  • 17 июля 2012 г.
    Максимальное время показа сайта увеличено до 15 минут, изменены правила задания параметра pkt, теперь время задается в секундах. Также добавлена возможность задавать интервал времени показа сайта.
    • edit - изменены правила задания параметра pkt, добавлен параметр pkt2.
    • set - изменены правила задания параметра pkt, добавлен параметр pkt2.
    • task - изменены правила задания группы параметров pktm.
  • 1 марта 2012 г.
    Добавлена возможность использования до трех дополнительных вкладок в режиме презентации.
    • edit - добавлен параметр prtab
    • set - добавлен параметр prtab
  • 2 марта 2011 г.
    Добавлена посуточная уникальность IP-адресов, а также возможность блокировки отключения сайта при его неработоспособности.
    • edit - добавлены параметры dayunick и dontstop.
    • set - добавлены параметры dayunick и dontstop.
  • 30 октября 2010 г.
    Добавлена возможность фильтрации посетителей с прокси-серверов.
    • edit - добавлен параметр proxy.
    • set - добавлен параметр proxy.
  • 14 сентября 2010 г.
    Добавлена возможность посещения сайта с эксклюзивного IP-адреса, т.е. того, который не посещал ранее сайты в системе как минимум в течение 48 часов.
    • edit - добавлен параметр ipex.
    • set - добавлен параметр ipex.
  • 16 августа 2010 г.
    Добавлена возможность показа сайта только в ручном серфинге.
    • edit - добавлен параметр msf. Добавлен вариант 7 для выходного массива с замечаниями по настройкам сайта.
    • set - добавлен параметр msf.
  • 16 июля 2010 г.
    Улучшено управление интервалом между показами сайта.
    • edit - удален параметр tml, добавлены параметры tml1, tml2, tmlc1, tmlc2, tmlrefresh.
    • set - добавлены параметры tml1, tml2, tmlc1, tmlc2.
    • task - изменен формат группы параметров pktml[0]-pktml[6].
    • taskset - изменен формат группы параметров i0-i6.
Поддержка
(ENGLISH)   МЕНЮ
 Главная страница
 Новости
 Правила
 О Системе
 Рекламодателям
 Партнерам
 Оплата
 Дилерам
 Помощь
 Путеводитель
 SafeSurf
 VirtualSurf
 Реферер по заказу
 Бонусы
 Безопасность
 Выкуп кредитов
 Реклама на сайте
 Контакты

АВТОРИЗАЦИЯ
Логин
Пароль
  
! Напомнить пароль
OpenID-авторизация

ПРИНИМАЕМ


РЕКЛАМА

Хостинг от JetHosting.ru

www.megastock.ru

Здесь находится аттестат нашего WM идентификатора 541133050115
Проверить аттестат

Уведомление об ответственности