Интерфейс используется для получения и установки настроек автоматического добавления кредитов и VIP-показов, а также для пополнения/снятия со счета кредитов и VIP-показов.
Для использования этого интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Помимо обязательных параметров, нужно передать следующие параметры:
Action: http://go.jetswap.com/api
Method: POST
PAY_ACTION: points
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
idst | Да | ID сайтов, для которых требуется выполнить команду. Содержит ID сайтов, разделенные двоеточием, например 123:234:456.
| op | Да | Вид операции:
- 0 - получить настройки автопополнения счета сайта
- 1 - пополнить счета сайтов
- 2 - снять со счетов сайтов
- 3 - установить настройки автопополнения счетов сайтов
| ac | Да при op>0 | Количество кредитов для добавления/снятия (при op=1/2 соответственно) со счетов сайтов
| av | Да при op>0 | Количество VIP-показов для добавления/снятия (при op=1/2 соответственно) со счетов сайтов
| mc | Да при op=3 | Минимальная сумма кредитов на счету сайта, при которой будет добавлено на счет ac кредитов.
| mv | Да при op=3 | Минимальная сумма VIP-показов на счету сайта, при которой будет добавлено на счет av VIP-показов.
|
Ответ: передается в формате URL Encoded массив, содержащем результаты выполнения операции для каждого переданного в idst сайта (см. пример ответа).
Параметр |
Описание |
notexists | Выдается значение 1 при отсутствии доступа к сайту с заданным ID или если сайт с таким ID не существует.
| cradd | Выдается при op=0. Количество кредитов для добавления/снятия (при op=1/2 соответственно) со счетов сайтов
| vipadd | Выдается при op=0. Количество VIP-показов для добавления/снятия (при op=1/2 соответственно) со счетов сайтов
| crmin | Выдается при op=0. Минимальная сумма кредитов на счету сайта, при которой будет добавлено на счет ac кредитов.
| vipmin | Выдается при op=0. Минимальная сумма VIP-показов на счету сайта, при которой будет добавлено на счет av VIP-показов.
| done | Выдается значение 1 при успешном выполнении операции (при op>0).
| error | Массив ошибок при выполнении операции. Каждый элемент массива содержит вложенный массив с кодом ошибки. Нулевой элемент вложенного массива содержит следующую информацию:
При op=1:
- 1 - У вас недостаточно кредитов на основном счету для перечисления на счет сайта
- 2 - У вас недостаточно VIP-показов на основном счету для перечисления на счет сайта
- 3 - Максимальный лимит VIP-показов на счету сайта - 999999.
- 4 - Максимальный лимит кредитов на счету сайта - 999999.
- 5 - сайт в черном списке и не может рекламироваться в системе.
При op=2:
- 1 - У вас недостаточно кредитов на счету сайта для перечисления на основной счет
- 2 - У вас недостаточно VIP-показов на счету сайта для перечисления на основной счет
|
Пример: сервером может быть выдан например ответ !647730[crmin]=0&647730[vipmin]=0&647730[cradd]=0&647730[vipadd]=0 при получении текущих настроек автопополнения счета.
После устранения ! перед ответом и обработки текста ответа функцией php parse_str выходной массив примет вид:
Array
(
[647730] => Array
(
[crmin] => 0
[vipmin] => 0
[cradd] => 0
[vipadd] => 0
)
)
Готовая функция для этого интерфейса на языке PHP доступна в списке API-интерфейсов при нажатии на значок "Пример PHP-кода"
|