API готов к работе!

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

Использование API поможет вам с легкостью проводить масштабные кампании в блогосфере.

Представляем вам функции, доступные на сегодняшний день.
1. Авторизация пользователя в системе

blogunApi_login(login,password,md5)
login – логин в системе
password – пароль
md5 – передаваемый пароль в формате md5 (0 или 1)

Возвращает:
answer (string) - ключ для доступа к функциям, требующим авторизации key

2. Выход пользователя из системы

blogunApi_logout(key)
key - ключ авторизации, полученный функцией blogunApi_login

Возвращает:
result (string)- 'ok' или 'error'

3. Получение баланса пользователя:

blogunApi_getBalance(key)
key - ключ авторизации, полученный функцией blogunApi_login

Возвращает:
result(float) - текущий баланс пользователя

4. Получение списка кампаний:

blogunApi_getProjects (key)
key - ключ авторизации, полученный функцией blogunApi_login

Возвращает:
campaigns(array)- список кампаний, который содержит:
idCampaign (int) - идентификатор кампании
AddDate (int) - дату создания
Title (string) - название кампании
PostCount (int) - количество размещенных публикаций
SumBilled (float) - потраченную сумму
SumReaders (int) - суммарное количество читателей
Status (string)– статус:"активна и приостановлена", "активна", "завершена"

5. Получение информации о конкретной кампании:

BlogunApi_getProjectInfo(idCampaign,time,key)
idCampaign - идентификатор кампании
time - временной промежуток от time->from до time->to
key - ключ авторизации, полученный функцией blogunApi_login

Возвращает:
campaignPosts (array)
idCampaign (int) – идентификатор кампании
Title (string) – название кампании
post(array) - массив публикации
idPost (int) - идентификатор публикации
PostDate (int) - дату публикации
Billed (float) - стоимость публикации
PostUrl (string) - url публикации

6. Изменение статуса кампании:

blogunApi_changeProject(idCampaign,action,key)
idCampaign - идентификатор кампании
action – действие над кампанией ('start', 'stop', 'open', 'close')
key - ключ авторизации, полученный функцией blogunApi_login

Возвращает:
result (string) - ok или error

7. Получение списка заявок от блогеров:

blogunApi_GetRequests(key, page)
key - ключ авторизации, полученный функцией blogunApi_login
page - номер страницы

Возвращает:
blogs (array)- список заявок:
idPost (int) - идентификатор поста
idBlog (int) - идентификатор блога
idCampaign (int) - идентификатор кампании
PostDate (int) - дату публикации
Billed (float) - стоимость публикации
PostUrl (string) - url публикации
size (string) -размер публикации
totalCount(int) - суммарное количество заявок

8. Получить список блогов согласно фильтру:

blogunApi_getBlogs(key, filter, page)
key - ключ авторизации, полученный функцией blogunApi_login
filter - параметры отбора
filter->CyFrom - тиц от
filter->CyTo - тицдо
filter->PrFrom - prот
filter->PrTo - pr до
filter->YandexIndexFrom - количество проиндексированных страниц в Яндексе от
filter->YandexIndexTo - количество проиндексированных страниц в Яндексе до
filter->GoogleIndexFrom - количество проиндексированных страниц в Гуглеот
filter->GoogleIndexTo - количество проиндексированных страниц в Гугледо
page - номер страницы

Возвращает:
blogs (array)- список блогов
url(string) - url блога
idBlog (int) - идентификатор блога
YandexTic (int) - показатель ТИЦ
GooglePR (int) - показатель PR
YIndexed (int) - количество проиндексированных страниц в Яндексе
GIndexed (int) - количество проиндексированных страниц в Гугле

В ближайшее время API будет пополняться и другими функциями. Следите за обновлениями!
Удачной вам рабочей недели!

Автор: Роман Клевцов