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

API

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


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

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

Статистика
Пользователей: 5946189

На запросы отвечает 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.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()
Возвращает id и названия категорий текстов

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

advego.getLangs()
Возвращает id и названия языков

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

advego.getUserBalance()
Возвращает количество денежных средств на счету.
Обязательные параметры:

  • token - token пользователя
Возвращаемые параметры:
  • money - количество денежных средств на основном счете (включает бонусы)
  • bonus - количество средств на бонусном счете
  • moneyblock - количество заблокированных средств

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

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

advego.getJobsAccepted()
Возвращает список принятых работ по всем заказам за указанный период. Указанный период не должен превышать 1 месяц.
Обязательные параметры:

  • 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 - размер страницы
Возвращаемые параметры:
  • 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.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.getJobsCompleted()
    Возвращает список выполненных работ по всем заказам за указанный период.
    Входные и выходные параметры: см. advego.getJobsAccepted()
    Если автор отказался от доработки, то к возвращаемым параметрам будет добавлен параметр "no_rework".

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

    advego.addOrder
    Создать заказ
    Обязательные параметры:

    • token - token пользователя
    • campaign_id - id кампании (advego.getMyCampaigns())
    • title - название заказа
    • description - описание заказа
    • order_type - тип заказа (advego.getOrderTypes())
    • category - категория заказа (advego.getCategories())
    • length - минимальный объем работы
    • Также при некоторых условиях обязательными становятся параметры из нижеперечисленных (см. по выделенному слову "обязательно" в следующем списке).
    Необязательные параметры:
    • start_order - если указан, то созданный заказ будет запущен (тип boolean)
    • tags - ключевые слова
    • 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 - за всё время)
      • author_jobs_limit - ограничение количества работ для одного исполнителя
      • author_jobs_interval - интервал времени, по истечении которого автор снова сможет взять указанное количество работ. Указывается в минутах (0 - за всё время)
      • jobs_interval - интервал времени, по истечении которого любой автор может взять заказ в работу. По умолчанию: без ограничения. Указывается в минутах (0 - за всё время)
      • 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.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.getOrderTypes()
    Возвращает id и названия типов заказов

    advego.getOrderTextTypes()
    Возвращает 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.getWhiteLists()
    Возвращает список белых списков Возвращаемые параметры:

    • id_list - id белого списка
    • list_name - название белого списка
    • list_users_cnt - количество пользователей в этом списке

    advego.getLevels()
    Возвращает список уровней пользователей Возвращаемые параметры:

    • id - id уровня
    • name - название уровня

    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.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.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.setOrderThemesOff()
    Выключает темы у заказа Обязательные параметры:

    • token - token пользователя
    • ID - id заказа
    Возвращаемые параметры:
    • error_code - цифровой код ошибки
    • error_msg - сообщение об ошибке
    или в случае успешного выполнения:
    • result - цифровой код возврата

    advego.setOrderThemesOn()
    Включает темы у заказа Обязательные параметры:

    • token - token пользователя
    • ID - id заказа
    Возвращаемые параметры:
    • error_code - цифровой код ошибки
    • error_msg - сообщение об ошибке
    или в случае успешного выполнения:
    • result - цифровой код возврата

    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.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 - ключевые слова
    • 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 - за всё время)
      • author_jobs_limit - ограничение количества работ для одного исполнителя
      • author_jobs_interval - интервал времени, по истечении которого автор снова сможет взять указанное количество работ. Указывается в минутах (0 - за всё время)
      • jobs_interval - интервал времени, по истечении которого любой автор может взять заказ в работу. По умолчанию: без ограничения. Указывается в минутах (0 - за всё время)
      • 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.addCampaign
    Создать кампанию
    Обязательные параметры:

    • token - token пользователя
    • title - название кампании
    Необязательные параметры:
    • desc - описание кампании
    • url - url сайта
    • category - id категории (advego.getCategories())
    Возвращаемые параметры:
    в случае ошибки:
    • errors - массив с ошибками, каждая ошибка содержит следующие поля:
      • error_code - цифровой код ошибки
      • error_msg - сообщение об ошибке
    или в случае успешного выполнения:
    • id - id кампании, по которому осуществляется дальнейшая работа

    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.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.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.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.ordersGetState()
    Возвращает состояние перечисленных заказов.
    Обязательные параметры:

    • token - token пользователя
    • orders - массив, содержащий id заказов
    Возвращаемые параметры:
    в случае ошибки:
    • errors - массив с ошибками, каждая ошибка содержит следующие поля:
      • error_code - цифровой код ошибки
      • error_msg - сообщение об ошибке
    или в случае успешного выполнения:
    • orders - массив с состояниями работ, каждый элемент содержит:
      • state - состояние заказа, возможные значения:
        • 1 - заказ остановлен заказчиком (или не запускался).
        • 2 - заказ активен (на модерации).
        • 3 - заказ активен (доступен исполнителям).
        • 4 - заказ остановлен администрацией.
        • 5 - заказ остановлен системой.
        • 6 - заказ удалён.
      • comment - текстовое описание состояния, если заказ был остановлен администрацией или системой
      • id_order - id заказа

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

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

    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.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, заявка отклонена

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

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