С радостью сообщаем: мы обновили функционал 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 будет пополняться и другими функциями. Следите за обновлениями!
Удачной вам рабочей недели!