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

seo

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

  • CompaniesGet
    COMPANIESGET
    получить список компаний
    вход: [archive] выводить все (вкл.архивные или нет)
    выход: [массив] компаний
  • CompanyAdd
    COMPANYADD
    добавить компанию
    вход: [name] название, [comment] комментарий
    выход: [ID] #компании, [-1] ошибка
  • CompanyDelete
    COMPANYDELETE
    удалить компанию
    вход: [company] #компании
    выход: [1] ок, [-1] ошибка, [-2] есть не удаленные проекты
  • CompanyUpdate
    COMPANYUPDATE
    обновить компанию
    вход: [company] #компании, [name] название, [comment] комментарий
    выход: [1] ок, [-1] ошибка
  • FiltersGet
    FiltersGet
    получить фильтры для всего аккаунта
    выход: [массив] массив фильтров
  • LinkDelete
    LinkDelete
    списать ссылку
    вход: [link] #ссылки, [inBlackList] заносить/не заносить сайт-донор в черный список
    выход: [1] ок, [-1] - ошибка
  • LinkGet
    LinkGet
    получить ссылку по Id
    вход: [id] #ссылки
    выход: структура ссылки
  • LinkPayByText
    LinkPayByText
    покупка ссылки по #текст
    вход: [site] #покупаемого сайта (донор), [pagesite] #покупаемой страницы (донор), [page] #страница проекта, [text] #текст, [сomment] комментарий к ссылке (не обязательно), [days] на сколько дней покупать (при посуточных оплатах указать 1)
    выход: [int] #ссылки, [0] невалидный анкор (не проходит под ограничения площадки), [-1] ошибка БД, [-2] нет свободных мест, [-3] текст ссылки не может быть размещен на сайте, [-4] дней должно быть >= 1, [-5] не существует #страницы проекта, [-6] пустой анкор, [-7] страница удалена из базы
  • LinkPayByTextLink
    LinkPayByTextLink
    покупка ссылки по тексту
    вход: [site] #покупаемого сайта (донор), [pagesite] #покупаемой страницы (донор), [page] #страница проекта, [anchor] текст, [uniqueCheck] проверка на уникальность,[сomment] комментарий к ссылке (не обязательно), [days] на сколько дней покупать (при посуточных оплатах указать 1)
    выход: [int] #ссылки, [0] невалидный анкор (не проходит под ограничения площадки), [-1] ошибка, [-2] нет свободных мест, [-3] текст ссылки не может быть размещен на сайте (остальные коды в LinkPayByText)
  • LinkSleep
    LinkSleep
    заморозить ссылку
    вход: [link] #ссылки
    выход: [1] ок, [-1] - ошибка
  • LinkUnSleep
    LinkUnSleep
    разморозить ссылку
    вход: [link] #ссылки
    выход: [int] #ссылки, [0] - нет свободных мест для размещения [-1] - ошибка
  • LinksGet
    LinksGet
    получить размещенные ссылки по странице
    вход: [page] #страницы
    выход: [массив] массив ссылок
  • PageAdd
    PageAdd
    добавить страницу
    вход:[url] url страницы, [payMode] режим покупки (ручной или автоматический), [projectId] #проекта,[uniqueCheck] проверка на уникальность, [createScenario] создавать сценарий по-умолчанию
    выход [ID] #страницы (если такая страница уже есть, то возвращается ее Id), [-1] общая ошибка, [-2] нет проекта или проект удален
  • PageChangePayMode
    PAGECHANGEPAYMODE
    изменить режим покупки страницы
    вход: [page] #страницы, [payMode] режим покупки (ручной или автоматический), [id] #страницы ок, [-1] ошибка
  • PageChangeUrl
    PAGECHANGEURL
    изменить url страницы
    вход: [page] #страницы, [url] новый url страницы
    выход [1] ok, [-1] ошибка
    Примечание: изменяет url во всех текстах и размещениях данной страницы, при условии, что ссылка куплена в рамках домена проекта
  • PageDelete
    PageDelete
    удалить страницу
    вход: [page] #страницы
    выход:
    [1] ок,
    [-1] страницы не существует,
    [-2] ошибка при удалении ссылки со страницы,
    [-3] ошибка при удалении страницы
  • PagesGetByProject
    PAGEGETBYPROJECT
    получить страницы по проекту
    вход: [project] #проект
    выход: [массив] список страниц
  • ProjectAdd
    ProjectAdd
    добавить проект
    вход: [mainpage] домен проекта, [name] название проекта, [company] #компании, [mode] тип проекта (Commercial - Коммерческий сайт, InternetShop - Интернет-магазин, Satellite - Сателит, SeoHammer - Проект системы SeoHammer, Manual - Ручной режим (совместимо с API), [findSameName] искать одинаковые проекты (по имени), [createPage] создавать страницу по умолчанию, [ssl] Проект работает на https
    выход [ID] #проекта, Если отрицательные - то ошибка:
    [-1] mainpage кривой
    [-2] mainpage пустой
    [-3] пользователь не определен
    [-4] кампания не определена
    [-5] проект с таким именем уже есть!
    [-6] ошибка в БД, пробовать еще раз
    Примечание: в проекте с mode=Commercial при добавлении каждого запроса автоматически будет создаваться страница проекта для обеспечения условия один запрос на одну страницу
  • ProjectChangeCompany
    PROJECTCHANGECOMPANY
    переместить проект в другую компанию
    вход: [project] #проекта, [company] #новой компании
    выход: [id] #проекта ок, [-1] ошибка, [-2] ошибка авторизации, [-3] не существующий проект
  • ProjectDelete
    PROJECTDELETE
    удалить проект
    вход: [project] #проекта
    выход: [1] ок, [-1] проекта нет, [-2] есть неудаленные страницы
  • ProjectsGet
    PROJECTGET
    получить проекты
    вход: [archive] показывать удаленные проекты
    выход: [массив] список проектов
  • ProjectsGetByCompany
    PROJECTGETBYCOMPANY
    получить проекты по компании
    вход: [company] #компании, [archive] показывать удаленные проекты
    выход: [массив] список проектов
  • ScenarioAdd
    ScenarioAdd
    добавить сценарий
    вход: [page] #страницы, [scenario] объект сценария
    выход: [ID] #сценария, [0] ошибка
  • ScenarioDelete
    ScenarioDelete
    удалить сценарии для страницы
    вход: [project] #проекта, [page] #страницы
    выход: [1] удалено, [0] ошибка
  • ScenarioLink
    ScenarioLink
    присоединить сценарий к странице через объект Автофильтра
    вход: [page] #страницы, [filterId] #фильтра, [autoFilter] авто-фильтр (объект с настройками), [autoStart] автоматически ставит в очередь сценарий на исполнение
    выход: [ID] #сценария (автофильтра), [отрицательные значения] ошибка:
    -1 нет доступа к странице проекта
    -2 нет доступа к проекту
    -3 нет доступа к фильтру
    0 - неизвестная ошибка
  • ScenariosGet
    ScenariosGet
    получить сценарии по странице
    вход: [project] #проекта, [page] #страницы
    выход: [массив] массив сценариев
  • ScenariosGetForId
    ScenariosGetForId
    получить сценарий по id
    вход: [project] #проекта, [page] #страницы, [scenarioid] #сценария
    выход: [объект] сценарий
  • SearchEngineRegionGet
    SearchEngineRegionGet
    список регонов поисковиков
    выход: [массив] список регонов поисковиков
  • TextAdd
    TEXTADD
    добавить текст
    вход: [text] текст, [uniqueCheck] проверка на уникальность
    выход: [ID] #текста, [-1] ошибка, [-2] текстов слишком много (более 10тыс. на одну страницу), [-3] напишите в службу поддержки...
  • TextDelete
    TEXTDELETE
    удалить тексты по странице проекта
    вход: [page] #страница, [text] #текста
    выход: [1] ок, [-1] ошибка
  • TextDeleteByProject
    TEXTDELETEBYPROJECT
    удалить тексты по проекту
    вход: [project] #проекта
    выход: [1] ок, [-1] ошибка
  • TextDeleteByProjectByPage
    TEXTDELETEBYPROJECTBYPAGE
    удалить тексты по странице проекта
    вход: [project] #проекта, [page] #страница
    выход: [1] ок, [-1] ошибка
  • TextGetByProject
    TEXTGETBYPROJECT
    получить тексты по проекту
    вход: [project] #проект
    выход: [массив] список текстов
  • TextGetByProjectByPage
    TEXTGETBYPROJECTBYPAGE
    получить тексты по странице проекта
    вход: [project] #проект, [page] #страницы
    выход: [массив] список страниц
  • TextsAdd
    TEXTSADD
    добавить масово тексты
    вход: [textList] список текстов, [uniqueCheck] проверка на уникальность
    выход: [int] кол-во залитых анкоров, [-1] ошибка, [-2] текстов слишком много (более 10тыс. на одну страницу)
  • WordAdd
    WordAdd
    добавить запрос
    вход: [page] #страницы, [text] текст запроса, [searchEngineRegion] #региона поисковика (0 - не указано)
    выход: [ID] #слова, [-1] общая ошибка, [-2] страницы нет (возможно, удалена)
  • WordDelete
    WORDDELETE
    удалить запрос
    вход: [page] #страницы, [word] #запроса
    выход: [1] ок, [-1] ошибка
  • WordGetByPage
    WORDGETBYPAGE
    список запросов по странице
    вход: [page] #страницы,
    выход: [массив] список слов по страницы
  • WordRegionAdd
    WordRegionAdd
    добавить регион для запроса
    вход: [page] #страницы, [word] #запроса, [searchEngineRegion] #региона поисковика (0 - не указано)
    выход: [1] добавлено, [-1] нету страницы у проекта, [-2] не указан регион, [-3] нет региона в справочнике