API для работы в MainLink
API для работы в MainLink
webmaster
Следующие операции поддерживаются. Формальное определение см. в Описание службы.
-
mlapi_AddSite
MLAPI: добавить новый сайт
вход: [Url] url домена (без http:// или https://), [Name] название сайта, [Description] описание сайта, [CategoryID] каталог сайта (см. справочники), [ScanSite] сканирование сайта при добавлении (true-сканировать, false-не сканировать), [ssl] - защищенный протокол (true, если сайт на https, или false)
выход: [0] неавторизован, [-1] некорректный урл домена, [-2] сайт с таким URL уже есть в базе, [-3] сайт недоступен, [-4] не добавлен (проблема с СУБД), [-5] письмо не отправлено, [-6] код не найден (или секьюрный файл не найден в коде, см. описание на сайте), [-7] проверьте название/описание (не более 100/1000символов) [целое] #ID добавленного сайта -
mlapi_AddSite_Anvanced
MLAPI: добавить новый сайт, подтвердив установку скрипта
вход: [Url] url домена (без http://), [pageiscode] url страницы на которой есть код (без http://), [Name] название сайта, [Description] описание сайта, [CategoryID] каталог сайта (см. справочники), [ScanSite] сканирование сайта при добавлении (true-сканировать, false-не сканировать), [ssl] - защищенный протокол (true, если сайт на https, или false)
выход: [0] неавторизован, [-1] некорректный урл домена, [-2] сайт с таким URL уже есть в базе, [-3] сайт недоступен, [-4] не добавлен (проблема с СУБД), [-5] письмо не отправлено, [-6] код не найден (или секьюрный файл не найден в коде, см. описание на сайте), [целое] #ID добавленного сайта -
mlapi_DeletePage
MLAPI: удалить страницу
вход: [PageID] #страницы сайта
выход: [-1] у страницы есть активные ссылки, [1] удалено -
mlapi_DeletePages
MLAPI: удалить страницы
вход: [массив] #страниц
выход: [массив] #страниц, статус ([-1] у страницы есть активные ссылки, [1] удалено) -
mlapi_DeleteSite
MLAPI: удалить сайт
вход: [SiteID] #сайта
выход: [true] удалено, [false] ошибка -
mlapi_DoCheckLink
MLAPI: произвести проверку ссылок на странице
вход: [LinkID] #ссылки, [SiteID] #сайта, [showDEBUG] показывать DEBUG-информаицю
выход: [пусто] OK, [непусто] описание ошибки -
mlapi_DoLink
MLAPI: произвести действие над ссылкой
вход: [LinkID] #ссылки, [Operation] Операция (1 - одобрить размещение (если еще не одобрена), 2 - списать, 3 - добавить в избранное , 4 - списать и занести в Черный список)
выход: [-1] ошибка, [0] авторизация не прошла, [LinkID] успешно -
mlapi_DoPage
MLAPI: произвести действие над страницей сайта
вход: [PageID] #ссылки, [SiteID] #сайта, [Operation] Операция (2 - пересчитать кол-во внешних ссылок)
выход: [-2] страницы нет или 500 ошибка [-1] ошибка c парсом страницы, [0] авторизация не прошла, [PageID] успешно -
mlapi_GetAllLinks
MLAPI: получить список всех ссылок по статусу
вход: [Status] статус ссылок
выход: [массив] ссылок -
mlapi_GetLinks
MLAPI: получить список купленных/неотмодерированных ссылок по сайту
вход: [SiteID] #сайта
выход: [массив] ссылок -
mlapi_GetLinks_byPage
MLAPI: получить список ссылок по странице
вход: [SiteID] #сайта, [PageID] #страницы (указывать обязательно оба параметра!)
выход: [массив] ссылок -
mlapi_GetLinks_byStatus
MLAPI: получить список ссылок по сайту и статусу
вход: [SiteID] #сайта, [Status] статус ссылок
выход: [массив] ссылок -
mlapi_GetPage
MLAPI: получить страницу по сайту
вход: [SiteID] #сайта, [PageID] #страницы
выход: [объект] страница -
mlapi_GetPageLevelLinks
MLAPI: уровни страниц для размещения ссылок (по PR и кол-ву кликов от главной со средней ценой и кол-вом своб. мест)
вход: [SiteID] #сайта
выход: [массив] значения уровней, [-1] - нет данных -
mlapi_GetPageLevelNotes
MLAPI: уровни страниц для размещения заметок (по PR и кол-ву кликов от главной со средней ценой и кол-вом своб. мест)
вход: [SiteID] #сайта
выход: [массив] значения уровней, [-1] - нет данных -
mlapi_GetPages
MLAPI: получить список страниц по сайту
вход: [SiteID] #сайта
выход: [массив] страниц -
mlapi_GetPages_WithPaging
MLAPI: получить список страниц по сайту с пейджингом
вход: [SiteID] #сайта, [StartPage] #Стартового элемента для вывода, [PageSize] #Кол-во элементов для вывода
выход: [массив] страниц, [TotalPages] #общее кол-во страниц для сайта