Автоматические интерфейсы 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 - получить код теста презентации сайта
- list - получить список сайтов
| | 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, предварительно узнав путь к файлу. Если что-то не работает, проконсультируйтесь у вашего хостинг-оператора.
Если какой-нибудь из этих пунктов вам непонятен, смотрите видео!
- История изменений интерфейсов
- 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.
|
