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

API

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


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

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

Вывод средств самозанятым

  • комиссия всего 1,5% + 40 руб.,
  • вывод за 1-2 рабочих дня,
  • легальный доход.

Пенсионерка / #48
Вызов поступил утром 30 декабря. Мученически морщась, Язвин завел служебный уазик и покатил пересчитывать ухабы по дороге в Березовку.

Потерпевшая жила в лесу. Искристый снег вокруг дома был расчищен и заскирдован, как на плацу в военной части. У калитки блестела мелкими игрушками карликовая елка. Язвин заглушил мотор, заправил в планшетку чистый протокол и хлопнул дверцей.



Все конкурсные работы | Обсуждение

На запросы отвечает 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_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 будет пересчитан
  • Количество работ и доступность заказа:
    • 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 - описание темы для заказчика
    • 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.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" для добавления в черный список
  • 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 должна быть не ранее 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()
Дополнительные выходные параметры:

  • autopayment_date - дата автооплаты работы
Если исполнитель отказался от доработки, то к возвращаемым параметрам будет добавлен параметр "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/