Каталог заказов
-
Статьи, переводы, копирайтинг
- Статья, обзор, SEO-копирайтинг
- Перевод
- Корректура текста, исправление ошибок
- Расшифровка аудио и видео, сканов и фото
-
Лайки, комментарии, соцсети, приложения
- Лайки в соцсетях
- Лайки без отзыва на сторонних ресурсах
- Репосты, подписки, голосования
- Приглашение пользователей в группы
- Публикации в соцсетях, репосты с комментариями
- Новая тема на форуме
- Комментарии на сайте заказчика
- Google Play, AppStore - оценка без отзыва
- Google Play, App Store - установка и отзывы
-
Отзывы, ссылки, маркетплейсы
- Яндекс и Google - карты, маркеты, справочники
- Отзовики, каталоги компаний
- Авито, маркетплейсы и доски объявлений
- Размещение ссылок на сайтах и форумах
- Продвижение бренда без ссылок
- Работа на сайте исполнителя
-
SEO, тесты, контент-менеджмент
- SEO-услуги
- Контент-менеджмент, работа на сайте заказчика
- Работа в поисковых системах, улучшение ПФ
- Поиск информации, полевые задания, чеки и бонусы
- Тестирование, разметка данных, картинок
-
Фото, видео, аудио
- Фото и видео
- Аудио и музыка
Поиск работы
Активация и управление подпиской на заказы доступны только при достижении уровня Специалист и выше либо при выполнении 5 работ.
Новости
- Приложение Адвего 1.9.16 для Android - обсуждение работ и заказов
- Заказчикам: поиск по активным заказам
- ТОП-100 участников конкурса "Самый мощный" определены!
- Поздравляем с наступающим 2025 годом!
- Сертификация Адвего для исполнителей / Возможность получить статус Гуру
- Донаты конкурса "Мистика Адвего"!
- Дополнительный кешбэк для юридических лиц
Все новости | Блог администрации
На запросы отвечает XML-RPC веб-сервис по адресу https://api.advego.com/xml
Пример запроса к API:<?xml version="1.0"?> <methodCall> <methodName>advego.getUserBalance</methodName> <params> <param><value> <struct> <member> <name>token</name> <value><string>1431a06b-xxxx-xxxx-xxxx-7ba8d4697e24</string></value> </member> </struct> </value></param> </params> </methodCall>Пример запроса к API с использованием массива:
<?xml version="1.0"?> <methodCall> <methodName>advego.ordersGetState</methodName> <params> <param><value> <struct> <member> <name>token</name> <value><string>1431a06b-xxxx-xxxx-xxxx-7ba8d4697e24</string></value> </member> <member> <name>orders</name> <value> <array><data> <value><int>1241235</int></value> <value><int>2351235</int></value> <value><int>1242355</int></value> </data></array> </value> </member> </struct> </value></param> </params> </methodCall>Внимание! Если текстовые поля содержат символы "<" и "&", то поле необходимо экранировать с помощью секции <![CDATA[ ]]>. Пример:
<member> <name>description</name> <value><string><![CDATA[Описание заказа с <html>]]></string></value> </member>
Авторизация
Для авторизации с каждым методом необходимо передать следующие параметры:
- token — ключ доступа к API.
Ключ можно сгенерировать и узнать на странице Настройки доступа
Ограничения по запросам
Количество секунд между вызоывами методов:
- advego.getStatAuthor: 60
- advego.getStatMaster: 60
- advego.searchForArticles: 10
- advego.getNoticesMoney: 600
- advego.orderGetNotices: 30
- advego.orderGetComments: 30
- advego.getJobsAccepted: 30
- advego.getJobsCompleted: 30
- advego.getJobsAll: 30
Категории методов API
- Работа с заказами
- Списки исполнителей
- Общение с исполнителями
- Жалобы на работы
- Статистика аккаунта
- Работа с магазином
- Ограничения и ошибки
Работа с заказами
Создание новой кампании (проекта)
advego.addCampaign
Создать кампанию
Обязательные параметры:
- token - token пользователя
- title - название кампании
- desc - описание кампании
- url - url сайта
- category - id категории (advego.getCategories())
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- id - id кампании, по которому осуществляется дальнейшая работа
Выгрузка своих кампаний (проектов)
advego.getMyCampaigns()
Возвращает список созданных активных кампаний
Возвращаемые параметры:
- id - id кампании
- title - название кампании
- desc - описание кампании
- url - url, указанный при создании кампании
- category - id категории (advego.getCategories())
- create_date - дата создания
- active_orders - количество запущенных заказов
- total_orders - общее количество заказов
- wait_jobs - количество работ, ожидающих модерации
- active_jobs - количество взятых в работу
- completed_jobs - количество выполненных работ
Создание заказа
advego.addOrder
Создать заказ
Обязательные параметры:
- token - token пользователя
- campaign_id - id кампании (advego.getMyCampaigns())
- title - название заказа
- description - описание заказа
- order_note - примечание к заказу, которое показывается только заказчику
- order_type - тип заказа (advego.getOrderTypes())
- category - категория заказа (advego.getCategories())
- length - минимальный объем работы
- Также при некоторых условиях обязательными становятся параметры из нижеперечисленных (см. по выделенному слову "обязательно" в следующем списке).
- start_order - если указан, то созданный заказ будет запущен (тип boolean)
- tags_json - список ключевых слов, каждое слово содержит:
- tag - ключевое слово
- count - точное количество раз, сколько это слово должно быть использовано в тексте
- tags_use - количество ключевых слов, которые нужно использовать
- lang - язык заказа (advego.getLangs())
- lang_translate_from - язык, на который нужно сделать перевод (для типа заказа перевод) (advego.getLangs())
- text_type - тип текста (advego.getOrderTextTypes()). Обязательный для заказов типа "Статья, обзор"
- url_not_clickable - данная опция не позволит переходить по ссылкам из вашего заказа напрямую (тип boolean)
- job_url_not_clickable - данная опция не позволит переходить по ссылкам из карточки заказа (тип boolean)
- export_enabled - разрешить экспорт оплаченных работ (тип boolean)
- close_post - закрыть обсуждение заказа (тип boolean)
- do_not_notify_on_unpopular - отключить автоматические уведомления о заказах, где долго не выполняются работы (тип boolean)
- send_mail - оповещать о выполненных работах (тип boolean), по умолчанию включен
- url - URL, по которому необходимо выполнить работу
- show_secret_desc - показать секретное описание (тип boolean)
- secret_desc_show_level - уровень видимости секретного описания
- 1 - Специалист
- 2 - Профессионал
- 3 - Эксперт
- 4 - Гуру
- 5 - Предварительный просмотр недоступен
- tender_desc - секретное описание заказа для одобренных исполнителей
- desc_with_html - если указан, то параметры tender_desc и description могут содержать форматирование в html, которое будет преобразовано в bb-коды. Допустимые теги (остальные будут удалены): <strong>, <b>, <i>, <em>, <u>, <ins>, <s>, <del>, <code>, <p>
- url - URL, по которому необходимо выполнить работу
- themes_active - включить темы заказа (тип boolean), если указан, то в заказ можно добавить несколько тем.
- Настройки публикации:
- publish_on_wm_site - публикация на сайте заказчика (тип boolean)
- publish_on_author_site - рекламная публикация на сайте исполнителя (тип boolean)
- publish_on_other_site - вирусная публикация на стороннем сайте (тип boolean)
- other_site_unique - проверять уникальность сайтов при вирусной публикации(тип boolean)
- Поиск исполнителей и ограничение доступа к заказу:
- authors - имена пользователей, через запятую, которые могут взять заказ в работу (или участвовать в тендере)
- exclude_authors - имена пользователей, через запятую, которые не увидят этот заказ
- approved_lists - пользователи из указанных белых списков (или уровня) смогут брать заказ в работу (массив или список через запятую)
- is_tender - принимать заявки от пользователей (тип boolean)
- auto_accept_request - автоматически выбирать лучшие заявки на тендер(тип boolean)
- auto_accept_period - период для автоматического принятия заявок в часах, по умолчанию 1 час, доступные значения: 0.25, 0.5, 1, 2, 3, 6, 12, 24, 48
- allowed_lists - пользователи указанного уровня (белые списки указывать нельзя) смогут подавать заяки (массив или список через запятую)
- default_list - id списка, в который будут добавляться одобренные исполнители (необязательный, данный список должен быть в approved_lists)
- is_auto_approve_further - добавлять исполнителей в список заказа при автооплате
- Настройки модерации:
- job_do_time - Время на выполнение работы исполнителем, в часах от 0.5 до 120, по умолчанию 6
- job_do_time_min - минимальное время на выполнение работы, в часах от 0.5 до 96. Применимо только при общем времени на выполнение более 24 часов
- job_check_time - Время на проверку выполненной работы, в часах от 24 до 120, по умолчанию 72
- no_moderate_jobs_limit - количество работ, которое может одновременно выполнить один исполнитель без проверки
- no_moderate_jobs_interval - период, за который исполнитель может выполнить указанное количество работ без проверки в минутах (0 - за всё время)
- Стоимость заказа, обязательно должен быть указан cost или cost_1000:
- cost - стоимость заказа
- cost_1000 - стоимость за 1000 знаков
- pay_amount - заказ с оплатой за объём (тип boolean). Параметры для данного вида заказов, обязательно должен быть указан cost_max или length_max:
- cost_max - максимальная стоимость за заказ (при оплате за объём)
- length_max - максимальный объем работы при оплате за объём. Если данный параметр задан вместе с cost_max, то cost_max будет пересчитан
- with_comission - если указан (тип boolean), в стоимости заказа сразу будет учтена комиссия Адвего - с баланса будет списываться ровно та сумма, которая указана в cost (cost_max, если активна оплата за объем) или равна cost_1000 * length (cost_1000 * length_max, если активна опдата за объем).
- Количество работ и доступность заказа:
- jobs_by_period - сколько работ должно выполняться за указанный период времени (jobs_period)
- jobs_period - период времени в минутах (0 - за всё время)
- jobs_total - необходимое количество работ. Обязательно указать либо jobs_total, либо jobs_unlimit
- jobs_unlimit - количество работ неограниченно (тип boolean).
- activity_interval - промежуток времени, через который заказ будет остановлен
- activity_units - единицы измерения для activity_interval. Допустимые значения: hours, days
- budget - бюджет заказа. Указанная сумма будет заблокирована на счету для данного заказа, оплата работ будет производиться из заблокированных средств.
- ip_limit - ограничение количества работа для одного IP адреса
- ip_interval - период для ограничение количества работа для одного IP адреса в минутах (0 - за 365 дней)
- author_jobs_limit - ограничение количества работ для одного исполнителя
- author_jobs_interval - интервал времени, по истечении которого исполнитель снова сможет взять указанное количество работ. Указывается в минутах (0 - за 365 дней)
- jobs_interval - интервал времени, по истечении которого любой исполнитель может взять заказ в работу. По умолчанию: без ограничения. Указывается в минутах (0 - за 365 дней)
- jobs_days - массив с номерами дней в неделе (1..7), в которые заказ будет доступен
- order_time_take_start - начало временного периода в течении которого заказ будет доступен, указываются часы от 1 до 24
- order_time_take_end - окончание временного периода в течении которого заказ будет доступен, указываются часы от 1 до 24
- media_required - если указан, то исполнитель должен обязательно приложить фото или скриншот к работе
- regions - список регионов, в которых доступен заказ, через запятую (advego.getCountriesList())
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- id - id заказа, по которому осуществляется дальнейшая работа с ним
Типы работ в системе
advego.getOrderTypes()
Возвращает id и названия типов работы
Типы текста для типа работы "TEXT / Статья, обзор, SEO-копирайтинг"
advego.getOrderTextTypes()
Возвращает id и названия типов статьи для заказа с типом работы "TEXT / Статья, обзор, SEO-копирайтинг"
Категории (тематики) работы и текстов
advego.getCategories()
Возвращает id и названия категорий текстов (применимо для заказов и магазина)
Язык работы и текстов
advego.getLangs()
Возвращает id и названия языков (применимо для заказов и магазина)
Изменение заказа
advego.editOrder()
Редактировать заказ.
Обязательные параметры:
- token - token пользователя
- ID - id заказа
-
См. параметры в advego.addOrder(). Для изменения какого-либо параметра достаточно указать только его.
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- id - id заказа
Запуск заказа
advego.startOrder()
Запускает указанный заказ
Обязательные параметры:
- token - token пользователя
- ID - id заказа
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Остановка заказа
advego.stopOrder()
Останавливает указанный заказ
Обязательные параметры:
- token - token пользователя
- ID - id заказа
- completed - если указан (тип boolean), то заказ будет полностью остановлен (после запуска такой заказ начнёт выполняться заново). При такой остановке параметр jobs_available станет равен 0, а параметр state станет равен 7, см. в методе advego.ordersGetState()
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Удаление заказа
advego.deleteOrder()
Удаляет указанный заказ
Обязательные параметры:
- token - token пользователя
- ID - id заказа
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Добавление работ к заказу
advego.orderMoreJobs()
добавляет или убирает работы из заказа. Если заказ был остановлен, то попытается его запустить. В случае ошибки при запуске: работы уже добавлены к заказу, нужно исправить причину и запустить заказ методом advego.startOrder
Обязательные параметры:
- token - token пользователя
- ID - id заказа
- jobs - количество работ, которое нужно прибавить. Можно указать отрицательное число, тогда работы будут убраны (нельзя указать меньше, чем -jobs_available)
- error_code - цифровой код ошибки. -100 - если работы не добавлены, другие значения - работы добавлены, но заказ не запущен.
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Выгрузка своих заказов
advego.getOrders()
Получить свои заказы
Обязательные параметры:
- token - token пользователя
- campaign_id - id кампании (advego.getMyCampaigns()), по которой будут возвращены заказы
- active - если указан, то будут возвращены только запущенные заказы
- id_order - если указан, то будет возвращен только заказ с данным ID
- date_from - если указан, то будут возвращены только заказы, созданные не ранее указанной даты
- date_to - если указан, то будут возвращены только заказы, созданные не позднее указанной даты
- page - номер страницы (1 если не указано)
- page_size - количество заказов на странице (1000 если не указано)
- get_desc_in_html - если указан, параметры заказа description и tender_desc вернутся с форматированием в html, вместо bb-кодов
- req - массив, содержащий имена параметров, которые необходимо вернуть. Если не задан, возвращаются все параметры.
Расстояние между date_from и date_to не должно превышать 1 месяц.
Возвращаемые параметры:
- id - id заказа
- is_active - 1 - если заказ запущен
- title - название заказа
- description - описание заказа
- order_note - примечание к заказу
- order_type - тип заказа (advego.getOrderTypes())
- category - категория заказа (advego.getCategories())
- length - минимальный объем работы
- tags_json - список ключевых слов, каждое слово содержит:
- tag - ключевое слово
- count - точное количество раз, сколько это слово должно быть использовано в тексте
- tags_use - количество ключевых слов, которые нужно использовать
- lang - язык заказа (advego.getLangs())
- lang_translate_from - язык, на который нужно сделать перевод (для типа заказа перевод) (advego.getLangs())
- text_type - тип текста (advego.getOrderTextTypes())
- url_not_clickable - данная опция не позволит переходить по ссылкам из вашего заказа напрямую (тип boolean)
- job_url_not_clickable - данная опция не позволит переходить по ссылкам из карточки заказа (тип boolean)
- export_enabled - разрешить экспорт оплаченных работ (тип boolean)
- url - URL, по которому необходимо выполнить работу
- tender_desc - секретное описание тендера
- themes_active - включить темы заказа, если указан, то в работу можно взять только тему
- is_moderated - 1 = если заказ прошёл модерацию
- state - состояние заказа (возможные значения advego.ordersGetState())
- comment - текстовое описание состояния, если заказ был остановлен администрацией или системой
- Настройки публикации:
- publish_on_wm_site - публикация на сайте заказчика (тип boolean)
- publish_on_author_site - рекламная публикация на сайте исполнителя (тип boolean)
- publish_on_other_site - вирусная публикация на стороннем сайте (тип boolean)
- Ограничение доступа к заказу:
- authors - имена пользователей, через запятую, которые могут взять заказ в работу (или участвовать в тендере)
- exclude_authors - имена пользователей, через запятую, которые не увидят этот заказ
- level - уровень исполнителей (advego.getLevels()), заказ будет доступен только исполнителям указанного уровня
- white_list - id белого списка пользователей (advego.getWhiteLists()), заказ будет доступен исполнителям из выбранного белого списка
- is_tender - тендер, приём заявок включён
- allowed_lists - id уровня, пользователи которого смогут подавать заяки
- approved_lists - id белых списков и уровней через запятую, пользователи из указанных белых списков (или уровня) смогут брать заказ в работу
- default_list - id списка, в который добавляются одобренные исполнители
- auto_accept_request - включен автоматический приём заявок
- auto_accept_period - период времени в часах для автоматического приёма заявок
- regions - список стран/регионов, в которых доступен заказ
- Настройки модерации:
- job_do_time - Время на выполнение работы исполнителем, в часах от 0.5 до 120, по умолчанию 6
- job_check_time - Время на проверку выполненной работы, в часах от 24 до 120, по умолчанию 72
- no_moderate_jobs_limit - количество работ, которое может одновременно выполнить один исполнитель без проверки
- no_moderate_jobs_interval - период, за который исполнитель может выполнить указанное количество работ без проверки в минутах (0 - за всё время)
- Стоимость заказа:
- cost - стоимость заказа
- cost_1000 - стоимость за 1000 знаков
- pay_amount - заказ с оплатой за объём (тип boolean).
- cost_max - максимальная стоимость за заказ (при оплате за объём)
- length_max - максимальный объем работы при оплате за объём
- Количество работ и доступность заказа:
- jobs_by_period - сколько работ должно выполняться за указанный период времени (jobs_period)
- jobs_period - период времени в минутах (0 - за всё время)
- jobs_total - необходимое количество работ.
- jobs_unlimit - количество работ неограниченно (тип boolean).
- days - количество дней, через которое заказ будет остановлен
- ip_limit - ограничение количества работа для одного IP адреса
- ip_interval - период для ограничение количества работа для одного IP адреса в минутах (0 - за 365 дней)
- author_jobs_limit - ограничение количества работ для одного исполнителя
- author_jobs_interval - интервал времени, по истечении которого исполнитель снова сможет взять указанное количество работ. Указывается в минутах (0 - за 365 дней)
- jobs_interval - интервал времени, по истечении которого любой исполнитель может взять заказ в работу. По умолчанию: без ограничения. Указывается в минутах (0 - за 365 дней)
- jobs_days - массив с номерами дней в неделе (1..7), в которые заказ будет доступен
- order_time_take_start - начало временного периода в течении которого заказ будет доступен, указываются часы от 1 до 24
- order_time_take_end - окончание временного периода в течении которого заказ будет доступен, указываются часы от 1 до 24
- budget_money_total - бюджет заказа
- budget_money - неизрасходаванный бюджет заказа
- budget_money_blocked - заблокированные средства из бюджета заказа
- Состояние заказа:
- create_date - дата публикации заказа
- modify_date - дата последнего изменения заказа
- jobs_active - количество в работе
- jobs_available - количество доступных работ
- jobs_wait - количество работ ожидающих модерации
- jobs_accepted - количество оплаченных работ
- jobs_accepted_total - количество оплаченных работ с момента с момента запуска
Выгрузка состояния заказов
advego.ordersGetState()
Возвращает состояние перечисленных заказов.
Обязательные параметры:
- token - token пользователя
- orders - массив, содержащий id заказов
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- orders - массив с состояниями работ, каждый элемент содержит:
- state - состояние заказа, возможные значения:
- 1 - заказ остановлен заказчиком (или не запускался).
- 2 - заказ активен (на модерации).
- 3 - заказ активен (доступен исполнителям).
- 4 - заказ остановлен администрацией.
- 5 - заказ остановлен системой.
- 6 - заказ удалён.
- 7 - заказ полностью остановлен заказчиком, после запуска заказ начнёт выполняться заново. При такой остановке параметр jobs_availavle становится равен 0. Для полной остановки заказа нужно использовать параметр completed в методе advego.stopOrder()
- comment - текстовое описание состояния, если заказ был остановлен администрацией или системой
- id_order - id заказа
Выгрузка извещений заказа
advego.orderGetNotices
Возвращает извещения по заказу
Ограничение: раз в 30 сек.
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- id_job - id работы, вернёт извещения связанные с этой работой
- author - имя исполнителя работы, вернёт извещения связанные с этим исполнителем
- from_notice - id извещения, вернёт извещения, созданные после данного
- from_date - дата в формате YYYY-MM-DD hh:mm:ss, вернёт извещения, созданные после указанной даты. Точность даты может быть до минут, до часов, до дня и т.д.
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - 1, означает что запрос выполнен успешно
- notices - список, содержащий извещения. Каждый элемент содержит следующие поля:
- id - id извещения
- date - дата появления извещения
- text - текст извещения
- header - заголовок извещения
- notice_type - тип извещения
Добавление (редактирование) тем в заказе
advego.editOrderThemes()
Создание и редактирование тем для заказа
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- themes - список тем редактируемых или добавляемых. Каждая тема имеет поля:
- id_theme - id темы. Если не указан, то будет создана новая тема для заказа. Если указан, то все поля указанной темы будут отредактированы
- title - название темы
- desc - описание темы для исполнителя
- note - описание темы для заказчика
- secret_desc - секретное описание темы для исполнителя (становится доступно после одобрения заявки или взятия заказа в работу)
- all_count - необходимое количество работ
- unlimit_count - если указан, ограничение на количество работ не используется
- tags - список ключевых слов для темы, каждое слово содержит:
- tag - ключевое слово
- count - точное количество раз, сколько это слово должно быть использовано в тексте
- tags_use - количество ключевых слов, которые нужно использовать.
- tags_in_name - ключевые слова перечислены в названии темы
- url - ссылка, по которой необходимо выполнить работу
- status - состояние темы. возможные значения:
- delete - удалить тему
- stop - остановить тему
- restart - перезапустить тему
- active - запустить тему
- action - действие, произведенное с темой, указывается, если не нужно редактировать всю тему. Возможные значения:
- change_status - изменилось только состояние темы
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- themes - список результатов обработки по темам. Может содержать следующие поля:
- id_theme - id темы, если обработка завершилась успешно
- errors - массив с ошибками, если были. Каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
Активация тем в заказе
advego.setOrderThemesOn()
Включает темы у заказа (обязательно только при создании тем через API)
Обязательные параметры:
- token - token пользователя
- ID - id заказа
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Отключение тем в заказе
advego.setOrderThemesOff()
Выключает темы у заказа (сами темы сохраняются и станут снова доступными при включении с помощью advego.setOrderThemesOn())
Обязательные параметры:
- token - token пользователя
- ID - id заказа
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Выгрузка тем заказа
advego.getOrderThemes()
Возвращает запрошенные темы
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- id_theme - id темы, будет возвращена тема с указанным id
- status - вернуть темы с заданным статусом. Если не указан, то будут возвращеные все темы по заказу. Возможные значения:
- delete - удаленные темы
- stop - остановленные темы
- complete - выполненные темы (по которым нет доступных работ)
- любой другой - активные темы
- sort - тип сортировки найденных тем. Возможные значения:
- a-z - сортировка по названию темы
- status - сортировка по статусу (активные, остановленные, удаленные)
- любой другой - без сортировки
- page - номер страницы, если указан, то будет возвращено только 1000 тем с указанной страницы.
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- id_order - id заказа, по которому был поиск
- themes - список найденных тем. Каждая тема имеет поля:
- id_theme - id темы
- create_date - дата создания темы
- title - название темы
- all_count - необходимое количество работ
- jobs_active - количество работ в процессе выполнения
- jobs_wait - количество работ, ожидающих модерации
- jobs_available - количество доступных работ либо unlimited, если число неограничено
- jobs_accepted - количество оплаченных работ
- desc - описание темы
- tags - список ключевых слов для темы, каждое слово содержит:
- tag - ключевое слово
- count - точное количество раз, сколько это слово должно быть использовано в тексте
- tags_use - количество ключевых слов, которые нужно использовать
- tags_in_name - ключевые слова перечислены в названии темы
- url - ссылка, по которой необходимо выполнить работу
- note - примечание к теме для заказчика
- status - состояние темы, возможные значения:
- delete - удалена
- stop - остановлена
- complete - выполнена (необходимое количество работ выполнено)
- active - активна
Активация бюджета заказа
advego.orderBudgetOn()
Включает бюджет у заказа. Указанная сумма будет заблокирована со счёта пользователя. Все последующие работы будут оплачиваться из бюджета заказа.
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- amount - размер бюджета
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Выключения бюджета заказа
advego.orderBudgetOff()
Отключает бюджет у заказа. Оставшийся бюджет вернётся на счёт пользователя. Предварительно необходимо остановить заказ.
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Изменение бюджета заказа
advego.orderBudgetChange()
Метод для увеличений/уменьшения бюджета заказа.
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- amount - сумма, которая будет добавлена к бюджету заказа (может быть отрицательной)
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Перезапуск бюджета заказа
advego.orderBudgetRestart()
Сбрасывает текущий бюджет и запускает заказ с новым бюджетом. Остаток текущего бюджета будет разблокирован, а новая сумма заблокирована со счёта пользователя
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- amount - размер нового бюджета
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - цифровой код возврата
Состояние бюджета заказа
advego.orderBudgetInfo()
Возвращает информацию о бюджете заказа.
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- budget_money_total - бюджет заказа
- budget_money - неизрасходаванный бюджет заказа
- budget_money_blocked - заблокированные средства из бюджета заказа
Заявки исполнителей
advego.getTenderRequests
Возвращает список заявок к тендеру.
Обязательные параметры:
- token - token пользователя
- id_order - id тендера
- id_theme id темы тендера
- submitter - имя подателя заявки
- state - состояние заявки, доступные значения:
- submitted - ожидает одобрения
- active - активная
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - список заявок:
- id_request - id заявки
- id_order - id заказа
- date_start - дата создания заявки
- date_end - дата истечения срока действия
- id_post - id поста на форуме
- id_theme - id темы
- id_job - id работы, если есть
- theme_name - название темы
- submitter_name - имя исполнителя заявки
- author_queue_size - размер очереди работ исполнителя в часах
- request_text - текст заявки
- request_number - номер заявки
Одобрение заявки
advego.acceptTenderRequest
Одобрить заявку на выполнение тендера
Обязательные параметры:
- token - token пользователя
- id_request - id заявки
- comment - комментарий для исполнителя
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- id_job - id созданной работы
Отклонение заявки
advego.declineTenderRequest
Отклонить заявку на выполнение тендера
Обязательные параметры:
- token - token пользователя
- id_request - id заявки
- comment - комментарий для исполнителя
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - 1, заявка отклонена
Оплата работы
advego.acceptJob()
Принять и оплатить указанную работу
Обязательные параметры:
- token - token пользователя
- ID - id работы
- comment - комментарий, не меньше 10 символов
- approve_for_tender - одобрить для последующих работ по тендеру (по умолчанию одобряется на все темы):
- 0 - не одобрять
- 2 - на все темы (значение по умолчанию)
- surcharge_value - доплата за работу в валюте счета, округляется до 2-х знаков после запятой
- surcharge_percent - доплата за работу в %, округляется до 2-х знаков после запятой
- add_to_list - для добавления исполнителя работы в список указывается id белого списка (advego.getWhiteLists()) или "black" для добавления в черный список
в случае ошибки:
- has_errors = 1
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- id_job - id работы
- money_payed - итоговая стоимость работы
- money_payed_comission - комиссия адвего
- has_errors = 0
Отправка работы на доработку
advego.returnJob()
Вернуть указанную работу на доработку
Обязательные параметры:
- token - token пользователя
- ID - id работы
- comment - комментарий, не меньше 10 символов
- add_to_list - для добавления исполнителя работы в список указывается id белого списка (advego.getWhiteLists()) или "black" для добавления в черный список
- do_time - время на доработку
в случае ошибки:
- has_errors = 1
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- id_job - id работы
- money_payed - итоговая стоимость работы
- money_payed_comission - комиссия адвего
- has_errors = 0
Отказ в оплате работы
advego.declineJob()
Отказать в выплате за указанную работу
Обязательные параметры:
- token - token пользователя
- ID - id работы
- comment - комментарий, не меньше 10 символов
- complaint - указывается, если необходимо создать жалобу на мошенничество. Возможные значения параметра:
- 1 - Спам
- 2 - Плагиат, копипаст, скан
- 3 - Низкое качество работы
- 4 - Другое
- complaint_comment - комментарий к жалобе
- add_to_list - для добавления исполнителя работы в список указывается id белого списка (advego.getWhiteLists()) или "black" для добавления в черный список
в случае ошибки:
- has_errors = 1
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- id_job - id работы
- money_payed - итоговая стоимость работы
- money_payed_comission - комиссия адвего
- has_errors = 0
Выгрузка оплаченных работ
advego.getJobsAccepted()
Возвращает список принятых работ по всем заказам за указанный период. Указанный период не должен превышать 1 месяц.
Для выгрузки работ, выполненных более чем 365 дней назад необходимо предварительно создать запрос на выгрузку работ из архива, см. advego.jobsArchiveRequest()
Обязательные параметры:
- token - token пользователя
- campaign_id - id кампании (advego.getMyCampaigns()), по которой будут возвращены работы
- id_order - если указан, то будут возвращены только работы по данному заказу
- id_theme - если указан, то будут возвращены только работы по данной теме
- with_html - если указан, то текст работы будет содержать html код, используемый для форматирования
- date_from - будут возвращены работы с датой не ранее указанной (если не указан, то за 7 дней до текущего момента). Вместе с датой можно указать время в формате: 14:15:29 (время указывается в GMT+0). Пример даты: 2016-09-06. Если не указан параметр date_to, дата в параметре date_from должна быть не ранее 365 дней от текущего момента.
- date_to - будут возвращены работы с датой не позднее указанной. Максимальный периол выгрузки (разница между date_from и date_to) - 365 дней.
- date_type - тип даты для интерпретации полей date_to, date_from. Допустимые значения: create - дата создания работы (по умолчанию), complete - дата выполнения работы, accept - дата оплаты работы (действует для работ оплаченных после 01.09.2016)
- page - номер страницы от 1
- page_size - размер страницы
- archive - если указан, то будут возвращены работы из архива (предварительно надо запросить доступ к архиву с помощью метода advego.jobsArchiveRequest())
- jobs - список найденных работ в порядке убывания даты выполнения. Каждая работы имеет поля:
- author_name - имя исполнителя работы
- id_job - id работы
- id_order - id заказа
- job_date - дата, когда копирайтер взял заказ в работу, в формате - Wed Jun 25 08:45:03 GMT 2014
- job_complete_date - дата выполнения работы
- job_accept_date - дата оплаты работы
- job_title - заголовок работы
- job_note - примечание к работе
- job_text - текст работы
- job_url - url работы, если есть
- id_theme - id темы заказа, если есть (advego.getOrderThemes())
- theme_title - название темы
- text_unique - уникальность текста работы по фразам в %. -1 - если уникальность не проверена.
- text_unique_words - уникальность текста работы по словам в %.
- is_auto - если параметр указан, то работа была оплачена автоматически
- cost -стоимость работы. Если заказ с оплатой за объём, то у неоплаченных работ будет указана макисмально возможная цена.
- cost_with_comission -стоимость работы с учётом комиссии. Если заказ с оплатой за объём, то у неоплаченных работ будет указана макисмально возможная цена.
- job_state - состояние работы, значения описаны в методе advego.jobGetState()
- moderate_times - количество доработок.
- job_domain_match - 1, если домен из url работы совпадает с указанным в заказе
- job_domain_unique - 1, если домен из url работы уникален (для заказов с настройкой other_site_unique)
- check_url - состояние проверки работы по URL, может иметь следующие значения:
- -2 - URL не доступен
- -1 - URL проверен, но текст не найден
- 0 - URL не проверен
- 1 - URL проверен, текст найден
- imgs - содержит массив с ссылками на картинки к работе (возвращается, если картинки есть)
Выгрузка выполненных работ
advego.getJobsCompleted()
Возвращает список выполненных работ по всем заказам за указанный период.
Входные и выходные параметры: см. advego.getJobsAccepted()
Дополнительные выходные параметры:
- autopayment_date - дата автооплаты работы
Выгрузка всех работ
advego.getJobsAll()
Возвращает список работ по всем заказам за указанный период. По умолчанию в список попадают работы, которые находятся в работе (job_state = 0), на модерации (job_state = 1, но job_state = 5, если исполнитель отказался от доработки) или оплачены (job_state = 2).
Дополнительные входные параметры:
- get_all - если указан, то будут возвращены работы во всех состояниях (тип boolean)
Выгрузка одной работы
advego.getJob()
Возвращает работу с указанным id_job
Обязательные параметры:
- token - token пользователя
- id_job - id работы
Выгрузка работ из архива
advego.jobsArchiveRequest()
Создаёт запрос на доступ к работам из архива (старше 1 года)
Обязательные параметры:
- token - token пользователя
- result - запрос успешно создан или
- date_valid - дата, до которой будет доступен архив с работами. Данный ответ означает, что запрос обработан и можно получать работы методом advego.getJobsAccepted()
Выгрузка состояния работы
advego.jobGetState()
Возвращает состояние работы. Данную функцию можно использовать для отслеживания обработки жалоб. Если работа перешла из состояние 2 в 3, то был совершен возврат средств администрацией. Если состояние изменилось из 3 в 2, то произошла принудительная оплата работы.
Обязательные параметры:
- token - token пользователя
- id_job - id работы
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- state - состояние работы, может принимать следующие значения:
- 0 - В работе
- 1 - Ожидает модерации
- 2 - Оплачена
- 3 - Отказано в оплате
- 4 - Исполнитель отказался
- 5 - Исполнитель отказался от доработки
- 8 - Работа в очереди на выполнение
- title - текстовое описание состояния
Выгрузка состояния нескольких работ
advego.jobsGetState()
Возвращает состояние работ. Работает аналогично методу advego.jobGetState(), только для нескольких работ
Обязательные параметры:
- token - token пользователя
- jobs - массив, содержащий id работ
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- jobs - массив с состояниями работ, каждый элемент содержит:
- state - состояние работы, возможные значения описаны в методе advego.jobGetState()
- title - текстовое описание состояния
- id_job - id работы
Списки исполнителей
Выгрузка системных ТОП-списков исполнителей
advego.getLevels()
Возвращает список системных уровней пользователей (ТОП-списков), для которых можно ограничивать доступ к заказу или поиск исполнителей, например ТОП-5000 и т. п.)
Возвращаемые параметры:
- id - id уровня
- name - название уровня
Выгрузка своих Белых списков (БС)
advego.getWhiteLists()
Возвращает список белых списков
Возвращаемые параметры:
- id_list - id белого списка
- list_name - название белого списка
- list_users_cnt - количество пользователей в этом списке
Добавление пользователя в свой список (БС или ЧС)
advego.addToList()
Добавляет пользователя в белый или черный список.
Обязательные параметры:
- token - token пользователя
- list - возможные значения:
- id белого списка - пользовтаель будет добавлен в этот список
- "black" - пользователь будет добавлен в черный список
- "new" - будет создан новый белый список, пользователь будет добавлен в него
- user - имя пользователя для добавления в список
- comment - комментарий о добавленном пользователе. Отображается только владельцу списка
- new_list_name - название нового белого списка
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
Удаление пользователя из своего списка (БС или ЧС)
advego.removeFromList()
Удаляет пользователя из белого или черного списка
Обязательные параметры:
- token - token пользователя
- list - возможные значения:
- id белого списка - пользовтаель будет добавлен в этот список
- "black" - пользователь будет добавлен в черный список
- user - имя пользователя для добавления в список
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
Общение с исполнителями
Добавление комментария в обсуждение заказа
advego.orderAddComment
Добавить комментарий в обсуждение заказа
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- comment - текст комментария
- parent - id комментария, в ответ комторому добавляется текущий
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - 1, означает что запрос выполнен успешно
- comment - структура с добавленным комментариям, поля структуры см. в методе advego.orderGetComments()
Выгрузка комментариев из обсуждения заказа
advego.orderGetComments
Возвращает комментарии из обсуждения заказа
Ограничение: раз в 30 сек.
Обязательные параметры:
- token - token пользователя
- id_order - id заказа
- parent - id комментария, если указан, то возвращены будут только комментарии из ветки этой ветки (включая данный комментарий)
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - 1, означает что запрос выполнен успешно
- comments - список, содержащий комментарии. Каждый элемент содержит следующие поля:
- id_comment - id комментария
- date - дата создания комментария
- text - текст комменатрия
- author - имя автора комменатрия
- votes_up - количество "Нравится"
- votes_down - количество "Не показывать"
- id_parent - id родительского комментария, если есть
- id_root - id корневого комментария
- level - уровень комменатрия
- number - номер комментария в обсуждении
- parent_number - номер родительского комментария в обсуждении
- comments_cnt - количество ответов на комментарий
Добавление комментария в обсуждение работы
advego.jobAddComment
Добавить комментарий в обсуждение работы
Ограничение: раз в 30 сек.
Обязательные параметры:
- token - token пользователя
- id_job - id работы
- comment - текст комментария
- parent - id комментария, в ответ комторому добавляется текущий
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - 1, означает что запрос выполнен успешно
- comment - структура с добавленным комментариям, поля структуры см. в методе advego.orderGetComments()
Выгрузка комментариев из обсуждения работы
advego.jobGetComments
Возвращает комментарии из обсуждения работы
Ограничение: раз в 30 сек.
Обязательные параметры:
- token - token пользователя
- id_job - id работы
- parent - id комментария, если указан, то возвращены будут только комментарии из ветки этой ветки (включая данный комментарий)
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - 1, означает что запрос выполнен успешно
- comments - список, содержащий комментарии. Структура списка описана в методе advego.orderGetComments()
Жалобы на работы
Жалоба на работу
advego.jobComplaint()
Создаёт жалобу на оплаченную или отказанную работу в личной переписке с администрацией (ЛПА), видна только заказчику и администрации.
Обязательные параметры:
- token - token пользователя
- id_job - id работы
- complaint - цифровой код причины жалобы, возможные значения:
- 4 - Другое
- 5 - Работа удалена
- complaint_comment - текст жалобы
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - 1, означает что запрос выполнен успешно
Добавление комментария в жалобу на работу
advego.jobComplaintAddComment
Добавить комментарий в жалобу по работе (может использоваться для публикации дополнительной информации по жалобе и при общении с администрацией)
Обязательные параметры:
- token - token пользователя
- id_job - id работы
- comment - текст комментария
- parent - id комментария, в ответ комторому добавляется текущий
Выгрузка комментариев из жалобы на работу
advego.jobComplaintGetComments
Возвращает комментарии из жалобы по работе
Обязательные параметры:
- token - token пользователя
- id_job - id работы
- parent - id комментария, если указан, то возвращены будут только комментарии из ветки этой ветки (включая данный комментарий)
Статистика аккаунта
Баланс аккаунта
advego.getUserBalance()
Возвращает количество денежных средств на счету.
Обязательные параметры:
- token - token пользователя
- money - количество денежных средств на основном счете (включает бонусы)
- bonus - количество средств на бонусном счете
- moneyblock - количество заблокированных средств
Выгрузка транзакций (финансовых операций)
advego.getNoticesMoney
Возвращает транзакции. Если не указаны какие-либо дополнительные параметры, то будут возвращены не более 50 транзакций за текущий месяц.
Ограничение: раз в 600 сек.
Обязательные параметры:
- token - token пользователя
- date - дата в формате YYYY-MM, вернёт извещения, созданные за указанный месяц. Если не задан, то будут возвращены транзакции за текущий месяц
- page - номер страницы
- per_page - количество записей на странице (от 10 до 1000)
в случае ошибки:
- errors - массив с ошибками, каждая ошибка содержит следующие поля:
- error_code - цифровой код ошибки
- error_msg - сообщение об ошибке
- result - 1, означает что запрос выполнен успешно
- total - общее количество извещений
- notices - список, содержащий извещения. Каждый элемент содержит следующие поля:
- type - Тип транзакции
- id - Номер извещения
- date - дата появления извещения
- ip_project - кампания
- id_order - Заказ
- id_job - Работа
- author - Исполнитель
- moeny_in - Доход
- money_out - Расход
- surcharge - Доплата
- money_total - Баланс
- money - Доступно
- money_blocked - Заблокировано
- money_total - Баланс
- message - Сообщение
- comment - Комментарий
Статистика заказчика
advego.getStatMaster()
Возвращает статистику заказчика за месяц.
Ограничение: раз в 60 сек.
Обязательные параметры:
- token - token пользователя
- date - месяц, за который нужно получить статистику, формат: YYYY-MM. Если не указан, то статистика будет получена за текущий месяц
- date - месяц, за которой возвращена статистика
- orders_count - общее число заказов за месяц
- stats - список, содержащий статистику за месяц. Каждый элемент содержит следующие поля:
- money_spent - расход за период в у.е.
- money_spent_new - расход за период в валюте счета в строковом формате
- money_in - количество денежных средств, зачисленных на счет
- money_in_new - количество денежных средств, зачисленных на счет в валюте счета в строковом формате
- jobs_take_master - взято в работу
- jobs_completed_master - выполнено исполнителями
- jobs_accept_master - количество оплаченных работ
- jobs_return_master - количество работ, возвращённых на доработку
- jobs_decline_master - количество отказанных работ
- jobs_cancel_master - отменено исполнителями
- stat_date - дата статистики, если значение не указано, то данная статистика за весь месяц
- months - список месяцев, за которые доступна статистика. Каждый элемент содержит дату в формате YYYY-MM
Статистика исполнителя
advego.getStatAuthor()
Возвращает статистику исполнителя за месяц.
Ограничение: раз в 60 сек.
Обязательные параметры:
- token - token пользователя
- date - месяц, за который нужно получить статистику, формат: YYYY-MM. Если не указан, то статистика будет получена за текущий месяц
- date - месяц, за которой возвращена статистика
- stats - список, содержащий статистику за месяц. Каждый элемент содержит следующие поля:
- money_earn - доход за период в у.е.
- money_earn_new - доход за период в валюте счета в строковом формате
- money_out - количество денежных средств, выведенных на кошелек
- jobs_take_author - взято в работу
- job_completed_author - выполнено
- jobs_cancel_author - отменено
- jobs_accept_author - количество оплаченных работ
- jobs_return_author - количество работ, возвращённых на доработку
- jobs_decline_author - количество отказанных работ
- stat_date - дата статистики, если значение не указано, то данная статистика за весь месяц
- months - список месяцев, за которые доступна статистика. Каждый элемент содержит дату в формате YYYY-MM
Работа с магазином
Поиск статей
advego.searchForArticles(struct params)
Ищет статьи в магазине статей. Ограничение: раз в 10 сек.
Обязательные параметры:
- token - token пользователя
- category - id категории текста (advego.getCategories())
- text_type - id типа текста (advego.getTextTypes())
- lang - id языка (advego.getLangs())
- author - ник исполнителя или массив исполнителей
- m - искать статьи только с картинками
- cost_from - минимальная цена
- cost_to - максимальная цена
- cost_1000_from - минимальная цена за 1000 символов
- cost_1000_to - максимальная цена за 1000 символов
- length_from - минимальная длина статьи
- length_to - максимальная длина статьи
- search - искать слова в тексте
- sort - сортировка (advego.getSortTypes())
- page - страница
- limit - количество статей на странице
- news - искать только статьи новости
- adv - искать только рекламные статьи
- ID - id статьи
- text_type - тип текста
- cost_1000 - цена за 1000 символов
- category - категория
- title - название статьи
- keywords_top - частотный словарь, самые часто встречающиеся слова (html)
- author - ник исполнителя
- cost - стоимость
- unique_percent - уникальность
- check_unique_date - дата проверки на уникальность
- date_modify - дата последнего изменения статьи
- syntax_errors - список слов, возможно написанных с ошибками
- words_cnt - количество слов
- lang_name - язык
- text_keywords - частотный словарь (html)
- length - длина статьи
- description - ссылка на картинку с кратким текстом img_previews - список ссылок на превью картинок к статьям
Покупка статьи
advego.buyArticle(int article_id)
Покупает статью, возвращает ее полный текст (поле text) и оригиналы картинок к статьям (поле imgs).
Обязательные параметры:
- token - token пользователя
- ID - id статьи
Выгрузка статей
advego.getArticle(int article_id)
Возвращает статью, если куплена, то полную версию.
Если статья куплена, то поле imgs содержит массив с ссылками на картинки к статье.
Если статья не куплена, то поле img_previews содержит массив с ссылками на миниатюры к картинкам из статьи.
Обязательные параметры:
- token - token пользователя
- ID - id статьи
Категории текстов
Язык текстов
Типы текста в магазине
advego.getTextTypes()
Возвращает id и названия типов текстов
Сортировка статей в магазине
advego.getSortTypes()
Возвращает id и названия видов сортировки
Возврат статьи
advego.complaintBadArticle()
Создаёт заявку на возврат средств за статью в ЛПА.
Обязательные параметры:
- token - token пользователя
- ID - id статьи
- reason - причина жалобы
- complaint_url - ссылка на тему в ЛПА или
- error - описание ошибки. Жалоба не создана.
Получение списка стран и городов для ограничений в заказе
advego.getCountriesList()
Возвращает список стран и регионов, которые можно использовать в качестве ограничений при создании или редактировании заказов.
В списке есть объекты со значением divider в качестве кода страны или региона. Данные объекты являются декоративными разделители для отображения списка.
- countries - массив стран, каждый элемент содержит поля:
- text - название страны
- country - код страны
- regions - объект со списком регионов. В качестве ключа используется код страны, к которой относятся регионы, значение - список регионов для данной страны, каждый элемент массива содержит поля:
- text - название региона
- region - код региона
Ограничения и ошибки
Ограничения на запросы
advego.getLimits()
Возвращает ограничения на вызов методов по api.
Обязательные параметры:
- token - token пользователя
- timeout - структура вида "название метода":"секунды"
Ошибки API
Описание кодов ошибок при работе с api тут