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

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

Action: http://caps.golddengi.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        ))

Готовая функция для этого интерфейса на языке PHP доступна в списке API-интерфейсов при нажатии на значок "Пример PHP-кода"

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