API для работы в MainLink
API для работы в MainLinkseo
Следующие операции поддерживаются. Формальное определение см. в Описание службы.
-
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] нет региона в справочнике
2005—2024 © MainLink.API