-{Title}- Интерфейсы управления рекламой сайтов -{/Title}- -{Content}- Автоматические интерфейсы 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 - секретный код, который вводится при настройке интерфейса, другие переменные описаны выше в этом пункте. Символы "::" не заменяются и служат разделителями переменных.

В случае удачного обращения к интерфейсу сервер вернет ответ в формате !Ответ, где Ответ будет содержаться в виде массива, закодированного функцией 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 вы можете изменять настройки сайтов автоматически в заданное время, не обладая специальными знаниями.

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

Если какой-нибудь из этих пунктов вам непонятен, смотрите видео!

-{/Content}- -{SecondContent}- -{/SecondContent}-