API для работы в MainLink

Следующие операции поддерживаются. Формальное определение см. в Описание службы.

• mlapi_AddProject
  MLAPI: добавить проект
  вход: [Name] название проекта, [www] урл проекта, [ProjectGroup] группа проекта, [FindSameName] искать одинаковые проекты (по имени), [Ssl] Проект работает по https
  выход [ID] #проекта, [-1] ошибка
• mlapi_AddProjectGroup
  MLAPI: добавить группу проектов
  вход: [Name] название, [Comment] комментарий
  выход: [ID] #группы проектов, [-1] ошибка
• mlapi_BuyLink
  MLAPI: покупка ссылки на странице
  вход: [SiteID] ID сайта, [PageID] ID страницы, [ProjectID] #проекта, [Link] текст ссылки, [Comment] комментарий к ссылке (не обязательно), [Days] на сколько дней покупать
  выход: [int] ID ссылки, [-1] ошибка, [-2] нет свободных мест, [-3] текст ссылки не может быть размещен на сайте, [-4] анкор не валиден, [-5] не хватает средств на покупку
• mlapi_BuyLinks
  MLAPI: покупка ссылки на странице
  вход: список ссылок выход: список ID размещеных ccылок, [Days] на сколько дней покупать
• mlapi_CancelBuyLink
  MLAPI: списать ссылку на странице
  вход: [LinkID] #ссылки, [InBlackList] заносить/не заносить сайт-донор в ЧС
  выход: [1] ок, [-1] - ошибка
• mlapi_ChangeTextLink
  MLAPI: смена текста ссылки
  вход: [LinkID] #ссылки, [anchor] новый анкор
  выход: [1] ок, [0] потеря связи с БД, [-1] ссылки не существует (нет авторизации), [-2] многолинк, [-3] незакрытая ссылка, [-4] текст больше 250 символов, [-5] домен больше 200 символов, [-6] домен в Черном списке, [-7] СТОП-слова
• mlapi_ChangeTextLinkByAnchor
  MLAPI: смена текста ссылки
  вход: [LinkID] #ссылки, [AnchorID] ID анкора (который уже есть в базе)
  выход: [1] ок, [0] потеря связи с БД, [-1] ссылки не существует (нет авторизации), [-2] многолинк, [-3] незакрытая ссылка, [-4] текст больше 250 символов, [-5] домен больше 200 символов, [-6] домен в Черном списке, [-7] СТОП-слова
• mlapi_DeleteProject
  MLAPI: удалить проект
  вход: [ID] #проекта
  выход: [1] ок, [-1] ошибка
• mlapi_DeleteProjectGroup
  MLAPI: удалить группу проектов (со всеми проектами и ссылками)
  вход: [ID] #группы
  выход: [1] ок, [-1] ошибка
• mlapi_DoLink
  произвести действие над ссылкой
  вход: [LinkID] #ссылки, [Operation] Операция (1 - одобрить размещение (в статусе Wait), 2 - отклонить ссылку, 3 - отклонить ссылку и занести сайт в Черный список сайтов, 4 - отклонить ссылку и занести страницу в Черный список страниц, 5 - заморозить ссылку, 6 - разморозить ссылку)
  выход: [-2] нет свободных мест для размещения, [-1] ошибка, [0] авторизация не прошла, [LinkID] успешно
• mlapi_FillAnchors
  MLAPI: залить анкоры в проект и папку
  вход: [ProjectID] #проекта, [DirectoryID] #папки, [AnchorList] список анкоров, [UniqueCheck] проверка на уникальность, [GroupId] #группы (0-группа не указана)
  выход: [int] кол-во залитых анкоров, [-1] ошибка
• mlapi_FillAnchorsAuto
  MLAPI: залить анкоры в проект для автопокупки
  вход: [ProjectID] #проекта, [AnchorList] список анкоров (при добавлении анкоров ID ссылки указывайте 0), [UniqueCheck] проверка на уникальность
  выход: [int] кол-во залитых анкоров, [-1] ошибка
• mlapi_GetAllLinks
  MLAPI: получить все купленные ссылки
  вход:-
  выход: [массив] массив ссылок
  Важно! Выводит только первые 10000 ссылок, если у вас больше - напишите на admin@mainlink.ru и вам будет предоставлен отдельный интерфейс
• mlapi_GetAllLinks_byStatus
  MLAPI: получить все ссылки по статусу
  вход: [LinkStatus] статус ссылок
  выход: [массив] массив ссылок
  выдаются первые 1000 ссылок, если вам нужно больше - обращайтесь в саппорт, вам сделают выгрузку по файлу
• mlapi_GetAnchors
  MLAPI: получить анкоры по проекту и папке (некупленные ссылки)
  вход: [ProjectID] #проекта,[DirectoryID] #папки
  выход: [массив] анкоров
• mlapi_GetAnchorsAuto
  MLAPI: получить анкоры по проекту для автопокупки (некупленные ссылки)
  вход: [projID] #проекта
  выход: [массив] анкоров
• mlapi_GetAnchorsCount
  MLAPI: получить кол-во анкоров по проекту (некупленные ссылки)
  вход: [ProjectID] #проекта
  выход: [int] кол-во анкоров
• mlapi_GetLinks
  MLAPI: получить купленные ссылки по проекту
  вход: [projID] #проекта
  выход: [массив] массив ссылок
• mlapi_GetLinks_byStatus
  MLAPI: получить купленные ссылки по проекту + по статусу
  вход: [projID] #проекта, [LinkStatus] статус ссылок
  выход: [массив] массив ссылок
• mlapi_GetPages
  MLAPI: найти страницы
  вход: [StartPage] #стартовой страницы (по аналогии с веб-поиском), [PageSize] #кол-во записей на странице, [CountPages] #кол-во страниц в поиске, [RestrictionPageOneSite] #кол-во страниц с сайта, [ExcludeProjectLinks] исключить сайты доноров, уже купленные в рамках проекта, [ExcludeCampaignLinks] исключить сайты доноров, уже купленные в рамках кампании, [ListParam]: параметры поиска
  выход: [массив] массив свободных страниц для размещения
• mlapi_GetProjectGroups
  MLAPI: получить группы проектов
  вход: [Archive] выводить все (вкл.архивные или нет)
  выход: [массив] групп проектов
• mlapi_GetProjects
  MLAPI: получить Проекты
  вход: [Archive] показывать удаленные проекты
  выход: [массив] список проектов
• mlapi_GetProjects_by_ProjectGroup
  MLAPI: получить Проекты по группе проектов
  вход: [ProjectGroup] #группы проектов, [Archive] показывать удаленные проекты
  выход: [массив] список проектов
• mlapi_MoveProject
  MLAPI: переместить проект в другую группу проектов
  вход: [ID] #проекта, [NewProjectGroup] #новой группы проектов
  выход: [ID] #проекта ок, [-1] ошибка, [-2] ошибка авторизации, [-3] не существующий проект
• mlapi_SetIndexed
  MLAPI: обновить данные по индексации ссылок
  вход: [массив ссылок] ссылки
  выход: [1] ок, [-1] потеря связи с БД
• mlapi_UpdateProject
  MLAPI: обновить проект
  вход: [ID] #проекта, [Name] название проекта, [www] урл проекта, [FindSameName] искать одинаковые проекты (по имени)
  выход: [ID] #проекта ок, [-1] ошибка
• mlapi_UpdateProjectGroup
  MLAPI: обновить группу проектов
  вход: [ID] #группы, [Name] название, [Comment] комментарий
  выход: [1] ок, [-1] ошибка