Конкуренты (устаревшая версия)

Актуальная версия API для настройки конкурентов проекта.
Эта версия перестанет поддерживаться 01.01.2019 года.

Действие Параметры GET Параметры POST Ответ
Добавить конкурента &oper=add&module=mod_projects&func=competitor project_id, competitors_sites {[result: id, site, name, on], message, error}
Удалить конкурента &oper=del&module=mod_projects&func=competitor id {result, message, error}
Включить/выключить конкурента &oper=edit&module=mod_projects main_project_id, id, on {result, message, error}
Переименовать конкурента &oper=edit&module=mod_projects main_project_id, id, name {result, message, error}

Описание параметров POST:

  • project_id – id проекта;
  • competitors_sites – URL сайта-конкурента;
  • id – id конкурента;
  • main_project_id – id проекта;
  • on – включение/выключение конкурента:
    • 0 - включить конкурента
    • -1 - выключить конкурента
  • name – имя конкурента;

Описание ответа:

  • result – результат выполнения запроса:
    • 0 - запрос не выполнен из-за ошибки;
    • 1 - запрос успешно выполнен;
  • message – сообщение об ошибке в формате Unicode Entities;
  • error – статус ошибки:
    • true - ошибка есть
    • false - ошибки нет
  • id – id конкурента;
  • site – URL конкурента;
  • name – имя конкурента;

Добавить конкурента example.com в проект XXX:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=add&module=mod_projects&func=competitor
&post[project_id]=XXX&post[competitors_sites]=example.com

Удалить конкурента X:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=del&module=mod_projects&func=competitor
&post[id]=XXX

Выключить конкурента X в проекте XXX:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=edit&module=mod_projects&post[main_project_id]=XXX
&post[id]=X&post[on]=-1