Актуальная версия 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