Интерфейс используется для добавления или изменения расписания показов выбранных сайтов. Добавление и изменение никак не отличаются - если расписания у сайта нет, оно будет добавлено, а если есть - изменено. В этом интерфейсе доступно управление всеми функциями расписания, в том числе и добавление VIP-показов по расписанию.
Для использования этого интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Помимо обязательных параметров, нужно передать следующие параметры:
Action: http://go.jetswap.com/api
Method: POST
PAY_ACTION: task
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
idst | Да | ID сайтов, для которых требуется выполнить команду. Содержит ID сайтов, разделенные двоеточием, например 123:234:456.
| pkhr[0]-pkhr[6] | Да | Количество показов в час для каждого дня недели, разделенное двоеточием. Дополнительный 25-й элемент означает количество показов в день для соответствующего дня. pkhr[0] означает настройки для воскресенья, pkhr[1] - для понедельника, pkhr[6] - для субботы. Если значение для соответствующего часа не введено, настройки для этого часа меняться не будут.
Пример: 0:1:2:3:4:5:6:7:8:9:10:11:12:13:14:15:16:17:18:19:20:21:22:23:2500, где 2500 - ограничение на количество показов в день, остальные настройки соответствуют каждому часу - 0 для 0 часов, 1 - для 1 часа и т.д.
| pkvip[0]-pkvip[6] | Да | Количество VIP-показов, которое следует добавить для соответствующего часа соответствующего дня недели. Состоит из 24 значений для каждого часа, разделенных двоеточием. pkvip[0] означает настройки для воскресенья, pkvip[1] - для понедельника, pkvip[6] - для субботы. Если значение для соответствующего часа не введено, это означает что для этого часа VIP-показы добавлять не нужно.
Пример: 0:1:2:3:4:5:6:7:8:9:10:11:12:13:14:15:16:17:18:19:20:21:22:23, где отдельные элементы соответствуют каждому часу - 0 для 0 часов, 1 - для 1 часа и т.д.
| pktm[0]-pktm[6] | Да | Время показа сайта для определенного часа и дня недели. Состоит из 24 значений для каждого часа, разделенных двоеточием. pktm[0] означает настройки для воскресенья, pktm[1] - для понедельника, pktm[6] - для субботы. Если значение для соответствующего часа не введено, это означает отсутствие изменений для этого часа. Для каждой ячейки значение 1 эквивалентно 30 секундам показа. Соответственно 45 секунд будет эквивалентно значению 1.5, 300 секунд (максимум) - значению 10.
Пример: 0:1:2:3:4:5:6:7:8:9:10:11:12:13:14:15:16:17:18:19:20:21:22:23, где отдельные элементы соответствуют каждому часу - 0 для 0 часов, 1 - для 1 часа и т.д.
| pktml[0]-pktml[6] | Да | Настройки интервала между показами сайта для определенного часа и дня недели. Состоит из 24 значений для каждого часа, разделенных двоеточием. pktml[0] означает настройки для воскресенья, pktml[1] - для понедельника, pktml[6] - для субботы. Если значение для соответствующего часа не введено, это означает отсутствие изменений для этого часа. Для каждой ячейки значение интервала задается в секундах.
Каждая ячейка имеет формат: tmlmin1;tmlmin2;tmlmax1;tmlmax2;tmlrefresh;tmlcmin1;tmlcmin2;tmlcmax1;tmlcmax2
- tmlmin1 и tmlmin2 - нижняя граница интервала между показами выбирается случайным образом от tmlmin1 до tmlmin2 для каждого часа
- tmlmax1 и tmlmax2 - верхняя граница интервала между показами выбирается случайным образом от tmlmax1 до tmlmax2 для каждого часа
- tmlrefresh - 0/1 - не/применять изменения сразу (в противном случае изменения интервала будут применены при следующем показе сайта)
- tmlminс1 и tmlminс2 - нижняя граница изменения интервала между показами выбирается случайным образом от tmlminc1 до tmlminc2 для каждого часа
- tmlmaxс1 и tmlmaxс2 - верхняя граница изменения интервала между показами выбирается случайным образом от tmlmaxc1 до tmlmaxc2 для каждого часа
Пример: 0;1;2;3;1;5;6;7;8:0;1;2;3;1;5;6;7;8... и т.д. с 0 до 23 часов, где отдельные элементы, разделенные : (0;1;2;3;1;5;6;7;8), соответствуют каждому часу первый элемент нулю часов, второй - первому часу и т.д. до 23 часов включительно.
|
Ответ: передается в формате URL Encoded массив, содержащем результаты выполнения операции для каждого переданного в idst сайта (см. пример ответа).
Параметр |
Описание |
notexists | Выдается значение 1 при отсутствии доступа к сайту с заданным ID или если сайт с таким ID не существует.
| done | Выдается значение 1 при успешном сохранении настроек расписания.
|
Пример: сервером может быть выдан например ответ !647730[done]=1.
После устранения ! перед ответом и обработки текста ответа функцией php parse_str выходной массив примет вид:
Array
(
[647730] => Array
(
[done] => 1
)
)
Результат удаления сайтов выдается отдельно для каждого ID сайта, переданного в параметре idst.
Готовая функция для этого интерфейса на языке PHP доступна в списке API-интерфейсов при нажатии на значок "Пример PHP-кода"
|