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] #общее кол-во страниц для сайта
  • mlapi_GetSite
    MLAPI: получить сайт по #сайта
    вход: [SiteID] #сайта
    выход: [массив] настроек сайта
  • mlapi_GetSiteSEOData
    MLAPI: получить текущий набор SEO-параметров
    вход: [SiteID] #сайта
    выход: [массив] изменения параметров
  • mlapi_GetSiteSQIHistory
    MLAPI: получить историю ИКС сайта
    вход: [SiteID] #сайта
    выход: [массив] изменения параметров, -5 - означает, что параметр не расчитывался
  • mlapi_GetSites
    MLAPI: получить сайты по аккаунту
    вход: -
    выход: [массив] сайтов
  • mlapi_StartScanning
    MLAPI: отправить на сканирование сайт
    вход: [SiteID] #сайта
    выход: [-1] сайт в процессе cканирования, [-2] сайт сканировался менее 6 часов назад, [-3] сайт под продажу сквозных ссылок, [-5] сканирование запрещено [SiteID] поставлен в очередь
  • mlapi_UpdateAutoScan
    MLAPI: установить автосканирование для сайта
    вход: [SiteID] #сайта, [AutoScan] включить/выключить автосканирование
    выход: [-1] ошибка, [SiteID] обновлено
  • mlapi_UpdateDiscounts
    MLAPI: установить скидки
    вход: [SiteID] #сайта, [Abiturient/Candidate/Doctor] скидка для абитуриента, кандидата, доктора (от 0 до 99)
    выход: [-1] ошибка, [-2] ошибка значений скидок, [SiteID] обновлено
  • mlapi_UpdateLinkPrice
    MLAPI: обновить цену ссылки на странице в долларах
    вход: [SiteID] #сайта, [PageSiteID] #страницы сайта, [Price] цена
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт не ваш, [-4] 0 < цена <= 1000, [PageSiteID] обновлено
  • mlapi_UpdateLinkPriceRUR
    MLAPI: обновить цену ссылки на странице в рублях
    вход: [SiteID] #сайта, [PageSiteID] #страницы сайта, [Price] цена
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт не ваш, [-4] 0 < цена <= 1000, [PageSiteID] обновлено
  • mlapi_UpdateLinksCount
    MLAPI: обновить кол-во продаваемых ссылок на страницах
    вход: [SiteID] #сайта, [PR] PageRank страниц, [ULevel] кол-во кликов от главной, [Count] кол-во ссылок
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт не ваш, [-4] 0 <= кол-во <= 10, [SiteID] обновлено
  • mlapi_UpdateLinksPrice
    MLAPI: обновить цены на ссылки в долларах
    вход: [SiteID] #сайта, [PR] PageRank страниц, [ULevel] кол-во кликов от главной, [Price] цена
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт не ваш, [-4] 0 < цена <= 1000, [SiteID] обновлено
  • mlapi_UpdateLinksPriceRUR
    MLAPI: обновить цены на ссылки в рублях
    вход: [SiteID] #сайта, [PR] PageRank страниц, [ULevel] кол-во кликов от главной, [Price] цена
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт не ваш, [-4] 0 < цена <= 1000, [SiteID] обновлено
  • mlapi_UpdateNotePrice
    MLAPI: обновить цену заметки на странице в долларах
    вход: [SiteID] #сайта, [PageSiteID] #страницы сайта, [Price] цена
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт не ваш, [-4] 0 < цена <= 1000, [PageSiteID] обновлено
  • mlapi_UpdateNotePriceRUR
    MLAPI: обновить цену заметки на странице в рублях
    вход: [SiteID] #сайта, [PageSiteID] #страницы сайта, [Price] цена
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт не ваш, [-4] 0 < цена <= 1000, [PageSiteID] обновлено
  • mlapi_UpdateNotesCount
    MLAPI: обновить кол-во продаваемых заметок на страницах
    вход: [SiteID] #сайта, [PR] PageRank страниц, [ULevel] кол-во кликов от главной, [Count] кол-во статей
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт не ваш, [-4] 0 <= кол-во <= 1, [SiteID] обновлено
  • mlapi_UpdateNotesPrice
    MLAPI: обновить цены на заметки
    вход: [SiteID] #сайта, [PR] PageRank страниц, [ULevel] кол-во кликов от главной, [Price] цена
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт не ваш, [-4] 0 < цена <= 1000, [SiteID] обновлено
  • mlapi_UpdatePage_Link
    MLAPI: обновить параметры продажи страницы - ссылки
    вход: [SiteID] #сайта, [PageID] #страницы (указывать обязательно оба параметра!), [Enabled] разрешить продажу, [PriceLink] цена ссылки (usd), [PriceLinkRur] цена ссылки (руб), [MaxLinks] максимальное кол-во ссылок
    выход: [int] PageID - ок, -1 ошибка, -2 проблема с сайтом, -3 нет доступа к сайту
  • mlapi_UpdatePage_Note
    MLAPI: обновить параметры продажи страницы - заметки
    вход: [SiteID] #сайта, [PageID] #страницы (указывать обязательно оба параметра!), [Enabled] разрешить продажу, [PriceNote] цена заметки (usd), [PriceNoteRur] цена заметки в рублях (rur), [MaxNotes] максимальное кол-во заметок
    выход: [int] PageID - ок, -1 ошибка, -2 проблема с сайтом, -3 нет доступа к сайту
  • mlapi_UpdatePages_Link
    MLAPI: обновить параметры продажи страницы - ссылки
    вход: масив #сайта, #страницы, включены/выключена от продаж, цена, количество размещений
    выход: масив #страницы, статус (#страницы - ок, -1 ошибка)
  • mlapi_UpdateSite
    MLAPI: обновить информацию по сайту
    вход: [SiteID] #сайта, [Name] название, [Description] описание, [CategoryID] #категории, [Email] осн. email, [Email2] доп. email
    выход: [-1] ошибка, [-2] слишком много запросов, [SiteID] обновлено
  • mlapi_UpdateSiteActive
    MLAPI: обновить информацию по сайту
    вход: [SiteID] #сайта, [Active] Продавать/Не продавать ссылки, [BlockNew] Продавать/Не продавать новые ссылки, [Premode] включить/выключить премодерацию сайта, [Packet] - включить/выключить пакетную продажу
    выход: [-1] ошибка, [SiteID] обновлено
  • mlapi_UpdateSiteGeo
    MLAPI: обновить гео-привязку сайта
    вход: [SiteID] #сайта, [YandexRegionId] Id по региону Яндекс, [GoogleRegionId] Id по региону Гугль
    выход: [-1] ошибка, [-2] сайт не найден, [-3] авторизация не прошла, [-4] не найден регион Яндекса, [-5] не найден регион Гугля, [SiteID] обновлено
  • mlapi_UpdateSiteSettings
    MLAPI: обновить информацию по сайту
    вход: [Структура сайта] Параметры:
    Active, BlockNew, Encoding, Hosting, Language, Mnogolink, Premoderation, Separator, StopWords, WebServer, WordsLength, WordsLengthAfter, WordsLengthBefore, Dictionaries: {Adult, BadWords, Games, Politics}
    выход: [-1] ошибка, [-2] нет доступа (проверьте SiteID), [SiteID] обновлено
  • mlapi_getScanStatus
    MLAPI: получить статус сканирования сайта
    вход: [SiteID] #сайта
    выход: [int] кол-во отсканированных страниц к текущему обращению (сайт в процессе сканирования), [-1] сайт в очереди на сканирование, [-2] сайт отсканирован, [-3] сайт еще не сканировался, [-5] ошибка (писать в суппорт)