Биржа копирайтинга Антиплагиат SEO анализ текста Скачать Advego Plagiatus Проверка орфографии
Адвего
Помощь и поддержка

API

боковая панель
Каталог заказов
Авторизация
E-mail: 
Пароль: 
  запомнить


Забыли пароль? Восстановить

Не зарегистрированы? Регистрация

На запросы отвечает 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>

Ключ доступа к 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
Общее ограничение по всем запросам - 60 шт. в минуту

Работа с заказами


Создание новой кампании (проекта)

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_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)
  • 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_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 будет пересчитан
  • Количество работ и доступность заказа:
    • 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
    • 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 - если указан, то исполнитель должен обязательно приложить фото или скриншот к работе
Возвращаемые параметры:
в случае ошибки:
  • 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 заказа
Возвращаемые параметры:
  • error_code - цифровой код ошибки
  • error_msg - сообщение об ошибке
или в случае успешного выполнения:
  • result - цифровой код возврата

Удаление заказа

advego.deleteOrder()
Удаляет указанный заказ Обязательные параметры:

  • token - token пользователя
  • ID - id заказа
Возвращаемые параметры:
  • error_code - цифровой код ошибки
  • 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_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 = если заказ прошёл модерацию
  • Настройки публикации:
    • 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 - период времени в часах для автоматического приёма заявок
  • Настройки модерации:
    • 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
  • Состояние заказа:
    • create_date - дата публикации заказа
    • modify_date - дата последнего изменения заказа
    • jobs_active - количество в работе
    • jobs_avaliable - количество доступных работ
    • 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 - заказ удалён.
    • 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 - описание темы для заказчика
    • 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.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 -одобрить для последующих работ по тендеру:
    • 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" для добавления в черный список
    Возвращаемые параметры:
    в случае ошибки:
    • 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 должна быть не ранее 30 дней от текущего момента.
    • date_to - будут возвращены работы с датой не позднее указанной. Максимальный периол выгрузки (разница между date_from и date_to) - 30 дней.
    • 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 - количество доработок.
      • check_url - состояние проверки работы по URL, может иметь следующие значения:
        • -2 - URL не доступен
        • -1 - URL проверен, но текст не найден
        • 0 - URL не проверен
        • 1 - URL проверен, текст найден
      • imgs - содержит массив с ссылками на картинки к работе (возвращается, если картинки есть)

    Выгрузка выполненных работ

    advego.getJobsCompleted()
    Возвращает список выполненных работ по всем заказам за указанный период.
    Входные и выходные параметры: см. advego.getJobsAccepted()
    Если исполнитель отказался от доработки, то к возвращаемым параметрам будет добавлен параметр "no_rework".

    Выгрузка всех работ

    advego.getJobsAll()
    Возвращает список работ по всем заказам за указанный период. В список попадают работы, которые находятся в работе, на модерации или оплачены.
    Входные и выходные параметры: см. advego.getJobsAccepted()

    Выгрузка работ из архива

    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 - Исполнитель отказался от доработки
    • 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.orderAddComment()

    Выгрузка комментариев из жалобы на работу

    advego.jobComplaintGetComments
    Возвращает комментарии из жалобы по работе
    Обязательные параметры:

    • token - token пользователя
    • id_job - id работы
    Необязательные параметры:
    • parent - id комментария, если указан, то возвращены будут только комментарии из ветки этой ветки (включая данный комментарий)
    Возвращаемые параметры см. в методе advego.orderGetComments()

    Статистика аккаунта


    Баланс аккаунта

    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.getCategories()

    Язык текстов

    см. advego.getLangs()

    Типы текста в магазине

    advego.getTextTypes()
    Возвращает id и названия типов текстов

    Сортировка статей в магазине

    advego.getSortTypes()
    Возвращает id и названия видов сортировки

    Возврат статьи

    advego.complaintBadArticle()
    Создаёт заявку на возврат средств за статью в ЛПА.
    Обязательные параметры:

    • token - token пользователя
    • ID - id статьи
    • reason - причина жалобы
    Возвращаемые параметры:
    • complaint_url - ссылка на тему в ЛПА
    • или
    • error - описание ошибки. Жалоба не создана.

    Ограничения и ошибки


    Ограничения на запросы

    advego.getLimits()
    Возвращает ограничения на вызов методов по api.
    Обязательные параметры:

    • token - token пользователя
    Возвращаемые параметры:
    • timeout - структура вида "название метода":"секунды"

    Ошибки API

    Описание кодов ошибок при работе с api тут

    Отправка жалобы...
    Спасибо, ваша жалоба принята
    Вы уже жаловались
    Ваша учётная запись заблокирована для участия в форуме.
    Жаловаться можно только на чужой комментарий
    Избранное
    Добавить в избранное
    Имя
    URL
    https://advego.com/info/api/