Каталог заказов
-
Статьи, переводы, копирайтинг
- Статья, обзор, SEO-копирайтинг
- Перевод
- Корректура текста, исправление ошибок
- Расшифровка аудио и видео, сканов и фото
-
Лайки, комментарии, соцсети, приложения
- Лайки в соцсетях
- Лайки без отзыва на сторонних ресурсах
- Репосты, подписки, голосования
- Приглашение пользователей в группы
- Публикации в соцсетях, репосты с комментариями
- Новая тема на форуме
- Комментарии на сайте заказчика
- Google Play, AppStore - оценка без отзыва
- Google Play, App Store - установка и отзывы
-
Отзывы, ссылки, маркетплейсы
- Яндекс и Google - карты, маркеты, справочники
- Отзовики, каталоги компаний
- Авито, маркетплейсы и доски объявлений
- Размещение ссылок на сайтах и форумах
- Продвижение бренда без ссылок
- Работа на сайте исполнителя
-
SEO, тесты, контент-менеджмент
- SEO-услуги
- Контент-менеджмент, работа на сайте заказчика
- Работа в поисковых системах, улучшение ПФ
- Поиск информации, полевые задания, чеки и бонусы
- Тестирование, разметка данных, картинок
-
Фото, видео
- Фото и видео
Новости
- Голосование 1-го тура литературного конкурса "Рассказы из детства" началось!
- Приложение Адвего 1.8.10 для Android - заказы, форум, конкурсы, вывод средств
- Самозанятые теперь зарабатывают на 5% больше!
- Заказчикам: ограничение по стране - бесплатно!
- Сертификация Адвего для исполнителей / Возможность получить статус Гуру
- Набор ночных модераторов
- С днём Победы!
Все новости | Блог администрации
Повороты судьбы / #55
В детстве нам часто приходилось переезжать. Я родился на чужбине, и моя семья никогда не оставалась на одном месте надолго. Там, где я родился, отец построил двухэтажный добротный дом, но всё же это были не наши места. Мой отец всю жизнь боролся за то, чтобы вернуться на родину, и, наконец, ему это удалось, когда мне было шесть лет. Через несколько лет после нашего возвращения ему удалось купить- Лето / #178
- Мыльная опера, или Что будет, если не уделять ребенку должного внимания / #184
- Все начинается с зайцев / #73
Все конкурсные работы | Обсуждение
На запросы отвечает 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)
- Настройки модерации:
- 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 - не одобрять
- 1 - на тему выполненной работы
- 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 тут