Уважаемые рекламодатели! Сегодня команда «Блогуна» с большим удовольствием и всей возможной торжественностью сообщает о появлении в системе чрезвычайно полезной функции — API.

API, Application Programming Interface, или «Эй-Пи-Ай» — набор готовых команд, с помощью которых ваш IT-специалист (штатный или фриланс-программист, системный администратор или кто-либо другой, общающийся с программным кодом на «ты») поможет вам настроить систему удалённого управления аккаунтом.

Теперь для работы с «Блогуном» нет необходимости даже заходить на наш сайт. Достаточно просто подключить компьютер к Интернету.

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

С какими ещё параметрами аккаунта вы бы хотели работать через API? С нетерпением ждём ваши предложения. Набор «инструментов управления» будет постоянно пополняться с учётом пожеланий рекламодателей.

Хотите обсудить тему прямой сейчас? Заходите на наш форум.

Ниже — техническая информация для программистов.

В API «Блогуна» используется протокол SOAP. Для получения wsdl-документа нужно подключаться к одному из наших адресов: blogun/api/blogun_api.wsdl либо к blogun/api/wsdl.php (любой из них может быть параметром в конструкторах классов, получающих wsdl для работы с SOAP). Можно отправлять xml-запросы напрямую по адресу: blogun/api/blogun_api.php.

Для того, чтобы работать с API, нужно авторизироваться при помощи функции blogunApi_login (имя пользователя и пароль). Если авторизация прошла успешно, функция вернёт ключ, используемый в дальнейшей работе с сервисом.

Доступные функции:

1) blogunApi_getProjects($key) — возвращает информацию о всех проектах. Параметры : $key — уникальный ключ.

2) blogunApi_getProjectInfo($idCampaign,$time,$key) - возвращает информацию о конкретной кампании (посты, стоимость задания, дата и др.) за определенный промежуток времени.
Параметры: $idCampaign - уникальный идентификатор кампании (можно получить при помощи функции blogunApi_getProjects); $time - структура данных. В пхп - объект ($time->from, $time->to), Поля должны быть интовские (timestamp); $key - уникальный ключ пользователя; дата передается в формате "гггг-мм-дд чч:мм:сс".

3) blogunApi_getBalance($key) — возвращает текущий баланс пользователя.

4) blogunApi_changeCampaign($idCampaign,$action,$key) — позволяет изменить состояние кампании в зависимости от параметра $action (start — возобновить, stop — приостановить, close — завершить, open — восстановить).

5) blogunApi_logout($key) — выход пользователя из сервиса. Чтобы зайти вновь, нужно снова вызвать функцию blogunApi_login.

Автор: