PR.SAPE.RU XML-RPC

Наш xml-rpc интерфейс доступен по адресу http://api.pr.sape.ru/xmlrpc/. Обращаться нужно по 80-ому порту, тело xml-запроса класть в POST_DATA. Всё общение происходит полностью в кодировке UTF-8.

Если Вы ещё ничего не знаете про XML-RPC, то рекомендуем почитать на сайте www.xmlrpc.com.
Также вас может заинтересовать:



Описания существующих функций

  • integer sape_pr.login(string $login, string $token, bool $obsolete_flag = false)
    Авторизация в системе; необходимо вызывать в начале каждой сессии. Далее при каждом следующем запросе нужно передавать все вернувшиеся cookie.
    Возвращает ID пользователя.
    Описания параметров:
    • string $login - Логин
    • string $token - Токен. Генерируется на странице https://passport.sape.ru/security/token/.
    • bool $obsolete_flag - Не используется. Сохраняется для совместимости и будет удалён; задавать его не нужно.
  • array sape_pr.project.index(struct $filter = [])
    Список проектов пользователя.
    Каждый элемент содержит:
    • id => (integer) ID проекта
    • name => (string) название вместе с типом
    • is_seo_checking => (boolean) проверяются ли заявки оптимизатором
    • is_archived => (boolean) находится ли в архиве
    • created_at => (string) дата создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • theme_name => (null|string) название тематики (если определена)
    • is_wizard => (boolean) создан ли через систему Wizard.Sape (самостоятельные операции запрещены)

    Описания параметров:
    • struct $filter - Необязательный массив фильтров; может включать в себя:
      • id => (integer) ID проекта
      • is_archived => (boolean) находится ли в архиве
      • is_wizard => (boolean) создан ли через систему Wizard.Sape
  • integer sape_pr.project.create(string $name, struct $params = [])
    Добавление проекта.
    Описание возможных настроек проекта: project.update (название проекта - "name" - задаётся явно первым аргументом).
    Описания параметров:
    • string $name - Название проекта
    • struct $params - Необязательный массив настроек проекта
  • void sape_pr.project.update(integer $id, struct $params = [])
    Изменение настроек проекта.

    Описания параметров:
    • integer $id - ID проекта
    • struct $params - Массив настроек:
      • auto_approve_min_index - автоматически принимать заявки, минуя статус проверки размещения, если %И площадки равен или превышает заданное значение (0 - отключить автопринятие; умолчание для нового проекта - 0)
      • check_index_mode - требование по индексации (умолчание для нового проекта - 3)
      • noindex_action - действие при неиндексации (умолчание для нового проекта - 0)
      • do_autobuy_twitt - автоматически тратить 10% от стоимости ссылок на ускорение индексации заявок (умолчание для нового проекта - 0)
      • is_auto_favorites - автоматически принимать, если сайт в избранном (умолчание для нового проекта - 0)
      • is_auto_indexed - автоматически принимать, если заявка проиндексирована (умолчание для нового проекта - 0)
      • is_auto_premoderation - автоматически подтверждать создание авторежимных заявок спустя 7 дней (умолчание для нового проекта - 1)
      • name - название
      • theme_id - ID тематики (либо NULL, чтобы указать её отсутствие; умолчание для нового проекта - NULL); список возможных тематик: project.themes_list
      Виды требований по индексации:
      • 0 - индексация не требуется
      • 1 - индексация в Яндексе
      • 2 - индексация в Google
      • 3 - индексация в Яндексе или Google
      Виды действий при неиндексации:
      • 0 - ничего не делать
      • 1 - пересоздать заявку на схожей площадке
      • 2 - пересоздать заявку, требующую подтверждения, на схожей площадке
      • 3 - отменить заявку с возвратом средств
  • void sape_pr.project.set_is_archive(integer $id, boolean $is_archived)
    Установка флага "архивности" проекта.
  • array sape_pr.project.themes_list()
    Возвращает известные системе тематики, определённые для домена или заданные для проекта.
    Каждый элемент массива содержит:
    • id - ID тематики
    • parent_id - ID родительской тематики (либо NULL, если не задана)
    • name - название
  • array sape_pr.project.adverts(struct $filter = [], integer $page = 1, integer $per_page = 500)
    Список заявок для проектов.
    Текст заявки можно получить методом advert.get_content.
    Каждый элемент содержит:
    • id
    • type - тип заявки
    • project_id - ID проекта
    • status - статус заявки
    • error - статус ошибки
    • wait_days - кол-во дней для размещения заявки вебмастером
    • in_yaca - площадка с данной заявкой есть в Яндекс.Каталог
    • in_dmoz - площадка с данной заявкой есть в DMOZ
    • in_yandex - площадка с данной заявкой есть в Яндекс.Новости
    • in_google - площадка с данной заявкой есть в Google News
    • in_novoteka - площадка с данной заявкой есть в Novoteka
    • in_rambler - площадка с данной заявкой есть в Рамблер-Новости
    • links - ссылки из заявки
    • price - стоимость
    • credit_period - длительность рассрочки
    • credit_status - статус рассрочки
    • site_url - URL площадки, на которой размещена заявка
    • placement_url - адрес размещения
    • cy - тИЦ площадки
    • pr - PR площадки
    • is_placement_guarantied - гарантия размещения вебмастером
    • is_placement_unique - признак уникальности текста размещённого материала
    • is_indexed - статус индексации
    • wait_index_days_left - количество дней до возможности отмены утверждённой заявки в случае, когда заявка ожидает индексации. В других случаях - null. Если число отрицательное, заявка может быть отменена в любой момент.
    • date_billing - дата списания средств
    • created_at - дата-время создания
    • updated_at - дата-время последнего какого-либо обновления
    • placed_at - дата-время размещения
    • status_at - дата-время установки последнего статуса
    • keywords - ключевые слова
    • description - примечание к заявке
    • version - версия примечания к заявке
    • title - заголовок (добавляется, если тип заявки - статья)
    • author - автор (добавляется, если тип заявки - статья)
    • insured_id - ID исходной заявки, на основе которой была создана новая по гарантии от снятия
    • noindex_id - ID исходной заявки, на основе которой была создана новая из-за неиндексации исходной

    Типы:
    • link - ссылка в новости
    • news - статья
    • archive - ссылка в архиве
    • review - обзор

    Статусы:
    • 4 - проверка модератором
    • 7 - на уточнении SEO
    • 5 - на размещении
    • 11 - проверка размещения
    • 12 - на доработке WM
    • 13 - требует подтверждения
    • 20 - размещена
    • 21 - отклонена вебмастером
    • 22 - отменена оптимизатором
    • 23 - отклонена модератором
    • 25 - определена к снятию
    • 26 - снята
    • 27 - отклонена роботом
    • 28 - отклонена роботом (WM)
    • 29 - отклонена роботом (SEO)

    Статусы рассрочки:
    • 1 - выплаты еще не начаты
    • 2 - идет выплата
    • 3 - идет выплата (списывается резерв)
    • 5 - выплаты приостановлены
    • 6 - недостаточно средств
    • 10 - выплаты завершены
    • 20 - выплаты прекращены из-за ошибки размещения

    Статусы ошибок:
    • 0 - без ошибок (ссылка найдена)
    • 1 - сервер недоступен
    • 2 - страница запрещена для индексирования в robots.txt
    • 3 - страница запрещена для индексирования в мета-тегах
    • 4 - некорректный URL
    • 5 - запрос перенаправляется на другую страницу
    • 7 - на странице используется rel="canonical" и адрес ссылки в теге не совпадает с адресом размещения в системе
    • 10 - ссылка не найдена
    • 11 - ссылка находится в <noindex>
    • 12 - текст ссылки отличается
    • 13 - в качестве текста ссылки написали "любой анкор"
    • 14 - текст ссылки содержит запрещённые слова
    • 15 - ошибка в кодировке страницы
    • 16 - ошибка в разметке страницы
    • 17 - получена пустая страница
    • 30 - проверка не завершилась
    • 40 - нельзя размещать ссылку на другом сайте
    • 41 - на этой странице уже есть размещенный материал

    Описания параметров:
    • struct $filter - Необязательные фильтры выборки:
      • advert_ids - массив ID заявок (иначе выбираются все заявки согласно остальным условиям выборки)
      • created_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой была создана заявка
      • created_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) была создана заявка
      • updated_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой заявка была обновлена
      • updated_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) заявка была обновлена
      • only_insurance_applied - признак, возвращать ли данные только по пересозданным заявкам по гарантии от снятия
      • only_noindex_recreated - признак, возвращать ли данные только по заявкам, пересозданным из-за неиндексации
      • only_recreated - объединение признаков "only_insurance_applied" и "only_noindex_recreated"
      • project_ids - массив ID проектов (иначе выбираются заявки из всех проектов пользователя)
      • status_codes - массив кодов статусов (иначе выборка по всем статусам заявки)
      • status_date_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой был установлен текущий статус заявки
      • status_date_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) был установлен текущий статус заявки
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • array sape_pr.project.twadverts(struct $filter = [], integer $page = 1, integer $per_page = 500)
    Список твит-заявок в проекте.
    Каждый элемент содержит:
    • id
    • project_id - ID проекта
    • status - статус заявки
    • tw_account_id - ID твит-аккаунта
    • price - стоимость
    • text - текст в теле твита
    • url - ссылка в теле твита
    • placement_url - адрес размещения
    • status_at - время смены статуса
    • placed_at - время размещения
    • created_at - время создания
    • is_paid - оплачена/не оплачена

    Статусы:
    • 1 - На размещении
    • 20 - Отправлена WM
    • 30 - В работе
    • 40 - Проверка размещения
    • 45 - Одобрена
    • 50 - Отменена WM
    • 51 - Отменена SEO
    • 52 - Отменена модератором
    • 53 - Отменена роботом

    Описания параметров:
    • struct $filter - Необязательные фильтры выборки:
      • advert_ids - массив ID твит-заявок (иначе выбираются все заявки согласно остальным условиям выборки)
      • project_ids - массив ID проектов (иначе выбираются заявки из всех проектов пользователя)
      • account_ids - массив ID твит-аккаунтов
      • status_codes - массив кодов статусов (иначе выборка по всем статусам заявки)
      • status_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой был установлен текущий статус заявки
      • status_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) был установлен текущий статус заявки
      • created_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой была создана заявка
      • created_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) была создана заявка
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • array sape_pr.project.social(struct $filter = [], integer $page = 1, integer $per_page = 500)
    Список заявок в социальных сетях для проектов.
    Каждый элемент содержит:
    (для type == 2):
    • id - ID социальной заявки
    • project_id - ID проекта
    • type - код типа
    • sn - код соц. сети
    • url - урл задания
    • nb_likes - кол-во лайков/постов/пользователей
    • nb_likes_current - кол-во на данный момент
    • price - стоимость за единицу
    • status - код статуса
    • daily_limit - лимит в день
    • text - текст задания
    • min_age
    • max_age
    • gender
    • marital_status
    • country
    • city
    • min_friends_count
    • max_friends_count
    • created_at - дата-время создания заявки
    • updated_at - дата-время обновления заявки
    • likes_data - массив данных о выполненных размещениях; каждый элемент содержит:
      • id - уникальный (в пределах социальной заявки) строковый ID выполнения лайка
      • url_location - URL страницы аккаунта
      • url_post - URL страницы размещения поста
      • posted_at - время размещения поста в формате UNIX timestamp
      • is_billed - признак, оплачено ли данное размещение
    (для type == 4):
    • id - ID социальной заявки
    • project_id - ID проекта
    • type - код типа
    • sn - код типа размещения
    • url - урл задания
    • nb_likes - кол-во лайков/постов/пользователей
    • nb_likes_current - кол-во на данный момент
    • price - стоимость за единицу
    • status - код статуса
    • daily_limit - лимит в день
    • is_concrete_url - признак, требовать ли от исполнителя строгого размещения заданного в заявке URL-а; иначе исполнитель размещает любой URL, найденный в домене, вырезанном из заданного оптимизатором URL-а
    • created_at - дата-время создания заявки
    • updated_at - дата-время обновления заявки
    • likes_data - массив данных о выполненных размещениях; каждый элемент содержит:
      • id - уникальный (в пределах социальной заявки) строковый ID выполнения лайка
      • url_post - URL страницы размещения
      • posted_at - время размещения в формате UNIX timestamp
      • is_billed - признак, оплачено ли данное размещение

    Коды типов социальных заявок:
    • 2 - Share / Ссылка на стене
    • 4 - Crowd / Ссылка из обсуждения

    Коды типов размещений:
    (для type == 2):
    • 1 - ВКонтакте
    • 2 - Facebook
    • 3 - Google+
    • 4 - Мой Мир
    (для type == 4):
    • 5 - любое
    • 6 - Ответы@Mail.Ru
    • 7 - форумы и комментарии к блогам

    Коды статусов:
    • 1 - создается
    • 2 - активна
    • 3 - останавливается
    • 10 - завершена
    • 11 - отменена
    • 100 - отменена из-за ошибки

    Описания параметров:
    • struct $filter - Необязательные фильтры выборки:
      • order_ids - массив ID заявок (иначе выбираются все заявки согласно остальным условиям выборки)
      • status_codes - массив кодов статусов (иначе выборка по всем статусам заявок)
      • types - массив кодов типов (иначе выборка по всем доступным типам заявок)
      • created_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой была создана социальная заявка
      • created_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) была создана социальная заявка
      • project_ids - массив ID проектов (иначе выбираются заявки из всех проектов пользователя)
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • struct sape_pr.project.finance_stats(string $period_group = "month", string $date_start = null, string $date_stop = null, array $projects_ids = [])
    Возвращает финансовые данные по проектам.
    Каждый элемент под соответствующим ключом (ID проекта) содержит подмассив с ключами - периодами:
    • period_date - период
    • sum_accepted - стоимость одобренных заявок
    • sum_billed - сумма фактически списанных в периоде средств по проектам
    • sum_billed_accepted - сумма фактически списанных средств по одобренным в периоде заявкам
    • sum_index_wait - стоимость одобренных заявок, которые ждут индексации
    • sum_potential - сумма ещё не списанных средств по одобренным в периоде заявкам
    • rejects - массив сумм возвращённых (не списанных) средств по видам отмен заявок:
      • sum_reject_index - заявки, отменённые из-за неиндексации
      • sum_reject_error - заявки, отменённые из-за ошибки размещения
      • sum_reject_sleep - заявки, отменённые по причине отсутствия средств у оптимизатора
      • sum_reject_moder - заявки, отменённые модератором

    Описания параметров:
    • string $period_group - разбиение на периоды по дням 'day' или месяцам 'month'
    • string $date_start - с какой даты 'ГГГГ-ММ-ДД' собирать данные (null - певое число текущего месяца)
    • string $date_stop - до какой даты 'ГГГГ-ММ-ДД' собирать данные (null - текущая дата)
    • array $projects_ids - ID проектов (массив не задан - все проекты)
  • array sape_pr.project.import_anchors(integer $project_id, array $anchors)
    Импортирует анкоры для проекта.
    Возвращает тот же массив $anchors, но с добавленными id:
    • url_id - ID URL-а
    • anchor_id - ID анкора
    • url - URL анкора
    • text - текст анкора

    Описания параметров:
    • integer $project_id - ID проекта
    • array $anchors - Массив импортируемых анкоров; каждый элемент должен содержать:
      • url - URL анкора
      • text - текст анкора
  • array sape_pr.site.average_prices(struct $filter = [])
    Средние цены для площадок.
    Функция возвращает массив, каждый элемент которого содержит:
    • cy_min - нижняя граница значения тИЦ (включительно)
    • cy_max - верхняя граница значения тИЦ (исключительно)
    • format - формат размещения
    • price - средняя цена для данной комбинации тИЦ/формата
    • site_ids - если задан входной фильтр site_ids, этот элемент будет содержать массив id площадок, соответствующих данному интервалу.

    Форматы размещения заявок:
    • link - ссылка в новости
    • news - статья
    • archive - ссылка в архиве
    • review - обзор

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • cy - значение тИЦ (работает совместно с format)
      • format - формат размещения (работает совместно с cy)
      • site_ids - массив ID площадок (действует независимо от cy и format)
  • array sape_pr.site.blog_types()
    Список блогплатформ.
    Функция возвращает массив, ключи которого - ID блогплатформ, а значения - их названия.
  • array sape_pr.site.categories(array $categories_ids = [])
    Список тематик.
    Функция возвращает массив:
    • ID тематики => название тематики

    Описания параметров:
    • array $categories_ids - - необязательный массив ID тематик (пустой массив - возвращаются все тематики).
  • array sape_pr.site.regions(integer $parent_id = null)
    Список регионов.
    Функция возвращает массив, ключи которого - ID регионов, а значения - массивы:
    • parent_id - ID региона, которому принадлежит данный
    • name - название региона

    Описания параметров:
    • integer $parent_id - Вернуть список регионов, принадлежащих заданному
  • array sape_pr.site.yacacats_tree()
    Дерево категорий Яндекс.Каталога.
    Представлено массивом с ключами - ID категорий верхнего уровня и значениями:
    • item - информация о категории:
      • id - ID категории
      • parent_id - ID родительской категории
      • name - название категории
    • subitmes - массив данных по подкатегориям (каждый элемент по структуре аналогичен структуре 'item')
  • integer sape_pr.site.request_create(struct $parameters)
    Создаёт запрос на добавление новой площадки. В случае успеха возвращает ID запроса.
    Описания параметров:
    • struct $parameters - Параметры запроса:
      Обязательные:
      • categories_list - массив ID тематик (от одной до трёх)
      • placement_section_path - мультистрокове описание путей до разделов размещения (пример пути: Главная → Архив статей → Выбираем год и месяц → Заявка)
      • url - URL площадки
      Необязательные:
      • description - описание площадки
      • price_link - цены ссылки в новости
      • price_news - цена статьи
      • price_archive - цена ссылки в архиве
      • price_review - цена обзора
  • array sape_pr.site.request_get(struct $filter = [], integer $page = 1, integer $per_page = 500)
    Возвращает данные по запросу на добавление площадки:
    • id - ID запроса
    • url - URL площадки
    • status - код статуса запроса
    • description - описание площадки
    • created_at - дата создания запроса в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • updated_at - дата изменения запроса в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • price_link - цена заявки для формата "ссылка в новости"
    • price_news - цена заявки для формата "статья"
    • price_archive - цена заявки для формата "ссылка в архив"
    • price_review - цена заявки для формата "обзор"
    • reject_reason - причина отказа
    • site_id - ID площадки (если запрос был одобрен)
    • placement_section_path - пути до разделов размещения

    Возможные коды статусов:
    • 2 - недостаточный тИЦ
    • 3 - ожидает проверки кода
    • 4 - ожидает проверки модератором
    • 10 - присутствует в Sape
    • 20 - одобрен
    • 21 - отклонен модератором
    • 22 - отклонён из-за низкой индексации Яндексом

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • created_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой были добавлены запросы
      • created_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) были добавлены запросы
      • ids - список ID запросов
      • status_codes - список кодов статусов
      • updated_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой запросы были обновлены
      • updated_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) запросы были обновлены
      • url - URL площадки
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • array sape_pr.site.search(string $type, struct $filter, integer $page, integer $per_page)
    Поиск площадок.
    Для каждого сайта будет возвращен массив со следующими параметрами:
    • id - ID сайта
    • url - url сайта
    • price - стоимость выбранного формата размещения
    • price_by_type - стоимости всех возможных форматов размещений:
      • link - стоимость размещения ссылки в новости
      • news - стоимость размещения cтатьи
      • archive - стоимость размещения ссылки в архиве
      • review - стоимость размещения обзора
    • cy - тИЦ
    • pr - PR
    • date_whois - whois площадки
    • pr - PR
    • in_yaca - находится в Я.Каталоге
    • in_dmoz - находится в DMOZ
    • ag_yandex - есть в Яндекс.Новостях
    • ag_google - есть в Google.Новостях
    • ag_novoteka - есть в Новотеке
    • ag_rambler - есть в Рамблер-Новости
    • advert_indexed_percent - процент индексации заявок
    • avg_placement_time - среднее время размещения заявки в днях
    • placement_uniqueness - уникальность размещений
    • placement_probability - процент размещения
    • days_to_index - средняя скорость индексации в днях
    • nof_pages_in_yandex - количество страниц, проиндексированных в Яндексе
    • nof_pages_in_google - количество страниц, проиндексированных в Google
    • yaca_categories - массив ID категорий Я.Каталога
    • categories_ids - массив ID тематик площадки
    • regions_ids - массив ID регионов площадки
    • is_mos - площадка принимает МОС-заявки
    • is_new - новая площадка
    • is_sape_links - площадка торгует ссылками в Sape
    • is_credit_available - принимается оплата в рассрочку
    • is_placement_outside_only - размещает ссылки только вне текста новости

    Описания параметров:
    • string $type - Формат размещения (link|news|archive|review)
    • struct $filter - Необязательный массив фильтров:
      • advert_indexed_percent_from - минимальный процент индексации заявок
      • advert_indexed_percent_to - максимальный процент индексации заявок
      • include_undefined - при заданном advert_indexed_percent_* включать в поиск площадки с неопределённым %И
      • avg_placement_time_from - минимальное среднее время размещения по заданному формату в днях
      • avg_placement_time_to - максимальное среднее время размещения по заданному формату в днях
      • id - ID площадки или массив ID площадок
      • price_from - цена от
      • price_to - цена до
      • cy_from - тИЦ от
      • cy_to - тИЦ до
      • placement_probability_from - минимальный процент размещения
      • placement_probability_to - максимальный процент размещения
      • pr_from - PR от
      • pr_to - PR до
      • whois_from - возраст площадки в днях (от)
      • whois_to - возраст площадки в днях (до)
      • in_yaca - находится в Я.Каталоге (0 - нет, 1 - да, 2 или не задано - не важно)
      • in_dmoz - есть в DMOZ (0 - нет, 1 - да, 2 или не задано - не важно)
      • ag_yandex - есть в Яндекс.Новостях
      • ag_google - есть в Google.Новостях
      • ag_novoteka - есть в Новотеке
      • cat_ag_filter_or - требовать наличия хотя бы в одном из указанных каталогов (in_*) или агрегаторов (ag_*)
      • is_credit_available - есть ли возможность покупать заявки в рассрочку (0 - нет, 1 - да, 2 или не задано - не важно)
      • is_placement_outside_only - размещение ссылок только вне текста (0 - нет, 1 - да, 2 или не задано - не важно)
      • is_non_thematic_advert - площадки принимают нетематические ссылки (0 - нет, 1 - да, 2 или не задано - не важно); только для форматов размещения 'link' и 'archive'
      • is_non_thematic_article - площадки принимают нетематические статьи или обзоры (0 - нет, 1 - да, 2 или не задано - не важно); только для форматов размещения 'news' и 'review'
      • project_id - ID проекта для фильтрации площадок по размещённым/отклонённым ссылкам, для учёта чёрного списка площадок у проекта и для исключения площадки, чей ID домена совпадает с ID домена проекта (если последний задан)
      • hide_inaction - {true|false} (требуется project_id) скрывать площадки с размещенными ссылками в рамках проекта
      • hide_rejected - {true|false} (требуется project_id) скрывать площадки с отклонёнными ссылками в рамках проекта
      • exclude_blogs - исключить площадки-блоги
      • include_only_blogs - искать только площадки блоги (игнорирует условие "exclude_blogs")
      • exclude_placed_other_sections - {true|false} (требуется "project_id") скрывать площадки с размещёнными заявками в рамках других проектов того же раздела
      • whitelists_ids - искать площадки присутствующие в указанных списках избранного
      • show_new - искать только среди новых сайтов
      • categories_ids - массив с ID тематик (см. список тематик) для поиска площадок, относящихся хотя бы к одной из этих тематик
      • regions_ids - массив с ID регионов (см. список регионов) для поиска площадок, относящихся хотя бы к одному из этих регионов
      • blog_types_ids - массив с ID блогплатформ (см. список блогплатформ) для поиска площадок, относящихся хотя бы к одной из этих блогплатформ
      • yacacats_ids - массив с ID тематик Яндекс.Каталога (см. дерево категорий Яндекс.Каталога) для поиска площадок, относящихся хотя бы к одной из этих категорий
      • no_sape_links - искать только те площадки, которые не торгуют ссылками в Sape (0 - нет, 1 - да, 2 или не задано - не важно)
      • is_mos - площадка принимает МОС-заявки
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (5000 max)
  • array sape_pr.site.ownlist(array $ids = [], struct $params = [], integer $page = 1, integer $per_page = 1000)
    Получить данные по собственным площадкам.
    По каждой площадке будет возвращён массив со следующими данными:
    • id - ID площадки
    • url - адрес площадки
    • is_active - true, если площадка активна
    • inactive_reason - причина деактивации
    • is_disabled - true, если площадка не принимает новые заявки
    • disabled_reason - причина, по которой площадка автоматически перестала принимать новые заявки
    • is_archive - true, если площадка архивирована
    • placement_propability - вероятность размещения
    • indexation_percent - процент индексации
    • uniqueness_percent - процент уникальности
    • days_to_index - средняя скорость индексации в днях
    • average_placement_times - массив со средними временами размещения (в часах) по форматам размещения заявок
    • advert_type_prices - массив с ценами на форматы размещения заявок
    • nofs_statuses - массив, каждый элемент которого содержит ключ - код статуса и значение - количество заявок в этом статусе
    • nofs_errors - массив, каждый элемент которого содержит ключ - код ошибки и значение - количество заявок с этой ошибкой
    • nofs_waiting_index - количетсво заявок, ожидающих индексации
    • created_at - дата создания площадки в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • nof_visitors - посещаемость
    • categories_ids - массив ID тематик площадки (полный список возможных значений)
    • regions_ids - список ID регионов площадок (полный список возможных значений)
    • is_ags - true, если площадка находится под АГС--

    Форматы размещения заявок:
    • link - ссылка в новости
    • news - статья
    • archive - ссылка в архиве
    • review - обзор

    Описания параметров:
    • array $ids - массив ID площадок (если не указать, выбираются все площадки)
    • struct $params - Необязательный массив параметров:
      • categories_ids - искать только площадки, среди тематик которых значится хотя бы одна из данного массива ID тематик (полный список возможных значений)
      • created_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой были созданы площадки
      • created_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) были созданы площадки
      • updated_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой площадки были обновлены
      • updated_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) площадки были обновлены
      • is_active - флаг: искать только активные (true) или только неактивные (false) площадки (со стороны системы)
      • is_ags - флаг: искать только площадки под АГС-- (true) или только площадки не под АГС-- (false)
      • is_archive - флаг: искать только архивированные (true) или только неархивированные площадки (false)
      • is_disabled - флаг: искать только скрытые (true) или только участвующие (false) в поиске площадки (со стороны вебмастера)
      • nofs_statuses - массив кодов статусов, по каждому из которых подсчитывать количество заявок
      • nofs_errors - массив кодов ошибок, по каждому из которых подсчитывать количество заявок
      • show_nofs_waiting_index - признак, показывать ли количество заявок, ожидающих индексации
      • show_no_price_TYPE - признаки фильтрации площадок, у которых не задана или указана неактивной цена формата размещения заявки "TYPE"
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (1000 max)
  • void sape_pr.site.update(integer $id, struct $params)
    Обновить параметры площадки.
    Описания параметров:
    • integer $id - ID площадки
    • struct $params - Параметры для обновления:
      • price_link: Цена за размещение ссылки
      • price_news: Цена за размещение статьи
      • price_archive: Цена за размещение ссылки в архиве
      • price_review: Цена за размещение за размещения обзора
      • contact: Контактная информация
      • placement_example: Примеры размещения
      • is_credit_available: Включить покупку в рассрочку (см. http://help.sape.ru/pr/faq/1206)
      • is_disabled: Не принимать новые заявки
      • is_placement_outside_only: Размещение ссылок только ВНЕ текста новости
      • is_non_thematic_advert: Принимаю нетематические ссылки
      • is_non_thematic_article: Принимаю нетематические статьи и пишу нетематические обзоры
      • is_changeable_url: Разрешено менять URL
      • is_changeable_anchor: Разрешено менять анкор
      • words_stop_list: Стоп-лист
      • is_stop_unprintable_words: Фильтровать нецензурные слова
      • is_stop_adult_words: Фильтровать adult-слова
      • description: Описание
  • array sape_pr.site.adverts(struct $filter = [], integer $page = 1, integer $per_page = 500, boolean $is_guest = false)
    Список заявок для площадок.
    Текст заявки можно получить методом advert.get_content.
    Каждый элемент содержит:
    • id
    • type - тип
    • site_id - ID площадки
    • site_url - домен площадки
    • status - статус
    • links - ссылки из заявки, где каждый элемент - подмассив:
      • id - ID ссылки
      • href - URL ссылки
      • text - анкор ссылки
      • anchor_id - ID анкора
      • anchor_parent_id - ID родительского анкора или null
      • steroid_alteration_id - ID стероида изменения ссылок или null; задан, если ссылка была создана благодаря данному стероиду
      • is_disabled_pending - признак, помечена ли ссылка к деактивации (удалению из задания)
      • href_encoded - кодированный URL
      • href_decoded - декодированный URL
      • href_utf8 - URL, конвертированный из win1251 в utf8
    • links_new_drafts - черновики новых ссылок, предложенных на замену "links" в рамках платной услуги "изменение ссылок"; если черновиков нет, содержит пустой массив; структура аналогична структуре "links"
    • price - стоимость (NULL, если нет прав на просмотр финансовых данных площадки)
    • billed - сумма уже выплаченных средств (NULL, если нет прав на просмотр финансовых данных площадки)
    • credit_period - длительность рассрочки
    • credit_status - статус рассрочки
    • placement_url - адрес размещения
    • placement_in_text - признак размещения ссылки в тексте материала
    • placement_out_text - признак размещения ссылки вне текста материала
    • is_placement_guarantied - гарантия размещения вебмастером
    • is_placement_unique - признак уникальности текста размещённого материала
    • is_indexed - статус индексации (null, если статус неизвестен)
    • is_seo_rework_possible - можно ли отправить заявку на доработку оптимизатору
    • wait_index_days_left - количество дней до отмены утверждённой заявки в случае, когда заявка ожидает индексации. В других случаях - null. Если число отрицательное, заявка может быть отменена в любой момент.
    • date_billing - дата зачисления средств
    • error - статус ошибки
    • wait_days - кол-во дней для размещения заявки вебмастером
    • created_at - дата-время создания
    • updated_at - дата-время последнего какого-либо обновления
    • placed_at - дата-время размещения
    • status_at - дата-время последнего статуса
    • description - примечание к заявке
    • keywords - ключевые слова
    • version - версия текста
    • title - заголовок (добавляется, если тип заявки - статья)
    • author - автор (добавляется, если тип заявки - статья)
    • is_mos - МОС-заявка

    Типы:
    • link - ссылка в новости
    • news - статья
    • archive - ссылка в архиве
    • review - обзор

    Статусы заявки:
    • 5 - на размещении
    • 7 - на уточнении SEO
    • 11 - проверка размещения
    • 12 - на доработке WM
    • 20 - размещена
    • 21 - отклонена вебмастером
    • 22 - отменена оптимизатором
    • 23 - отклонена модератором
    • 24 - отклонена стоп-листом
    • 25 - определена к снятию
    • 26 - снята
    • 27 - отклонена роботом
    • 28 - отклонена роботом (WM)
    • 29 - отклонена роботом (SEO)

    Статусы рассрочки:
    • 1 - выплаты еще не начаты
    • 2 - идет выплата
    • 3 - идет выплата (списывается резерв)
    • 5 - выплаты приостановлены
    • 6 - недостаточно средств
    • 10 - выплаты завершены
    • 20 - выплаты прекращены из-за ошибки размещения

    Статусы ошибок:
    • 0 - без ошибок (ссылка найдена)
    • 1 - сервер недоступен
    • 2 - страница запрещена для индексирования в robots.txt
    • 3 - страница запрещена для индексирования в мета-тегах
    • 4 - некорректный URL
    • 5 - запрос перенаправляется на другую страницу
    • 7 - на странице используется rel="canonical" и адрес ссылки в теге не совпадает с адресом размещения в системе
    • 10 - ссылка не найдена
    • 11 - ссылка находится в <noindex>
    • 12 - текст ссылки отличается
    • 13 - в качестве текста ссылки написали "любой анкор"
    • 14 - текст ссылки содержит запрещённые слова
    • 15 - ошибка в кодировке страницы
    • 16 - ошибка в разметке страницы
    • 17 - получена пустая страница
    • 30 - проверка не завершилась
    • 40 - нельзя размещать ссылку на другом сайте
    • 41 - на этой странице уже есть размещенный материал

    Описания параметров:
    • struct $filter - Массив необязательных фильтров:
      • accepted_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой заявки были одобрены к оплате (в т. ч. проиндексированы)
      • accepted_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) заявки были одобрены к оплате (в т. ч. проиндексированы)
      • advert_ids - массив ID заявок (иначе выбираются все заявки согласно остальным условиям выборки)
      • billed_at_start - дата в формате "ГГГГ-ММ-ДД", начиная с которой заявки были (будут) оплачены
      • billed_at_stop - дата в формате "ГГГГ-ММ-ДД", до которой (включительно) заявки были (будут) оплачены
      • created_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой были созданы заявки
      • created_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) были созданы заявки
      • error_codes - массив кодов ошибок (иначе выборка по всем ошибкам заявки)
      • only_links_alteration - признак, искать ли только заявки, по которым есть новые заказы на изменение ссылок
      • only_wait_index - признак, искать ли только заявки, ждущие индексации
      • site_ids - массив ID площадок (иначе выбираются заявки из всех площадок пользователя)
      • status_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой у заявок менялся статус
      • status_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) у заявок менялся статус
      • status_codes - массив кодов статусов (иначе выборка по всем статусам заявки)
      • types - массив типов заявок (иначе выборка по всем типам)
      • updated_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой заявки были обновлены
      • updated_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) заявки были обновлены
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
    • boolean $is_guest - Искать по гостевым площадкам (false - собственным)
  • struct sape_pr.site.finance_stats(string $period_group = "month", string $date_start = null, string $date_stop = null, array $sites_ids = [])
    Возвращает финансовые данные по площадкам.
    Каждый элемент под соответствующим ключом (ID площадки) содержит подмассив с ключами - периодами:
    • period_date - период
    • sum_accepted - стоимость одобренных заявок
    • sum_billed - сумма фактически зачисленных в периоде средств по площадкам
    • sum_billed_accepted - сумма фактически зачисленных средств по одобренным в периоде заявкам
    • sum_index_wait - стоимость одобренных заявок, которые ждут индексации
    • sum_potential - сумма ещё не зачисленных средств по одобренным в периоде заявкам
    • rejects - массив сумм возвращённых (не зачисленных) средств по видам отмен заявок:
      • sum_reject_index - заявки, отменённые из-за неиндексации
      • sum_reject_error - заявки, отменённые из-за ошибки размещения
      • sum_reject_sleep - заявки, отменённые по причине отсутствия средств у оптимизатора
      • sum_reject_moder - заявки, отменённые модератором

    Описания параметров:
    • string $period_group - Разбиение на периоды по дням 'day' или месяцам 'month'
    • string $date_start - С какой даты 'ГГГГ-ММ-ДД' собирать данные (null - певое число текущего месяца)
    • string $date_stop - До какой даты 'ГГГГ-ММ-ДД' собирать данные (null - текущая дата)
    • array $sites_ids - ID площадок (пустой массив - все площадки)
  • array sape_pr.site.get_favorites(array $filter = [])
    Возвращает избранные площадки в виде массива, в котором ключами являются ID площадок, а значениями - URL площадок.
    Описания параметров:
    • array $filter - Фильтр по массиву ID или URL площадок в стандартном формате, punycode или киррилице
  • void sape_pr.site.add_favorites(array $urls_or_ids)
    Добавляет площадки в избранное.
    Описания параметров:
    • array $urls_or_ids - Массив ID или URL площадок в стандартном формате, punycode или киррилице
  • void sape_pr.site.remove_favorites(array $urls_or_ids)
    Удаляет площадки из избранного.
    Описания параметров:
    • array $urls_or_ids - Массив ID или URL площадок в стандартном формате, punycode или киррилице
  • void sape_pr.site.remove_favorites_all()
    Удаляет из избранного все площадки.
  • string sape_pr.advert.create(string $type, integer $project_id, integer $site_id, struct $params)
    Создание заявки.
    Описания параметров:
    • string $type - Формат размещения (link|news|archive|review)
    • integer $project_id - ID проекта
    • integer $site_id - ID площадки
    • struct $params - Параметры создания заявки:
      • wait_days - период ожидания (дней)
      • max_price - максимальная цена покупки
      • credit_period - период рассрочки 90 или 180 дней. Для создания заявок с разовой оплатой (не в рассрочку) - параметр credit_period указывать не нужно
      • instant_if_no_credit - если площадка не принимает заявки в рассрочку, создать заявку с единовременной оплатой
      • is_text_final - запретить склонение текста ссылки
      • place_in_text - размещение в тексте
      • place_outside - размещение вне текста
      • set_warranty - назначить заявке 1 год платной гарантии от снятия
      Для заявок форматов link|archive|review:
      • text - текст заявки
      • any_text_anchor - заявка создается с признаком "любой анкор"
      Для заявок формата news:
      • article_id - id статьи для размещения
      Параметры "place_in_text" и "place_outside" устанавливаются только для заявок с форматом размещения "link".
  • struct sape_pr.advert.get(integer $id)
    Получение параметров заявки.
    Возвращаемый массив содержит:
    • id - ID
    • type - формат размещения
    • site_id - ID площадки
    • site_url - URL площадки
    • status - код статуса (см. текстовые расшифровки в описании site.adverts)
    • credit_period - длительность рассрочки
    • credit_status - код статуса рассрочки (см. текстовые расшифровки в описании site.adverts)
    • placement_url - адрес размещения
    • placement_in_text - признак размещения ссылки в тексте материала
    • placement_out_text - признак размещения ссылки вне текста материала
    • is_placement_guarantied - гарантия размещения вебмастером
    • is_indexed - статус индексации (null, если статус неизвестен)
    • wait_index_days_left - количество дней до отмены утверждённой заявки в случае, когда заявка ожидает индексации. В других случаях - null. Если число отрицательное, заявка может быть отменена в любой момент.
    • date_billing - дата зачисления средств
    • wait_days - кол-во дней для размещения заявки вебмастером
    • created_at - дата-время создания
    • updated_at - дата-время последнего какого-либо обновления
    • status_at - дата-время установки текущего статуса
    • placed_at - дата-время размещения
    • is_mos - (только для WM) является ли МОС-заявкой
    • price - стоимость (NULL, если нет прав на просмотр финансовых данных площадки)
    • billed - сумма выплаченных (для SEO) или заработанных (для WM) средств (NULL, если нет прав на просмотр финансовых данных площадки)
    • project_id - (только для SEO) ID проекта
    • error - (только для WM) код статуса ошибки (см. текстовые расшифровки в описании site.adverts)
    • is_placement_unique - (только для WM) признак уникальности текста размещённого материала

    Описания параметров:
    • integer $id - ID заявки
  • struct sape_pr.advert.get_content(integer $id, integer $revision = null)
    Получение задания заявки.
    Возвращаемый массив содержит:
    • body - текст (ссылки + примечание)
    • links - ссылки из заявки
    • links_new - новые ссылки, предложенные на замену "links" в рамках платной услуги "изменение ссылок"
    • description - примечание к заявке
    • author - автор (для статей)
    • title - заголовок (для статей)
    • version - версия текста

    Описания параметров:
    • integer $id - ID заявки
    • integer $revision - Номер версии описания задачи. По-умолчанию, текущая.
  • void sape_pr.advert.cancel(integer $id)
    Отмена заявки оптимизатором.
    Описания параметров:
    • integer $id - ID заявки
  • void sape_pr.advert.approve(integer $id, integer $placement_type = null)
    Утверждение размещения.
    Описания параметров:
    • integer $id - ID заявки
    • integer $placement_type - Способ размещения.
      Если для заявки уже указан конкретный способ размещения, $placement_type указывать не нужно. Если для заявки указаны оба способа размещения (как в тексте, так и в не текста), укажите в качестве $placement_type явно выбранный тип размещения:
      • 1 - в тексте
      • 2 - вне текста
      При этом, если будет указан способ 2 (вне текста), заявка будет отправлена модератору на перепроверку.
  • void sape_pr.advert.premoderate(integer $id)
    Подтвердить создание заявки (дать вебмастеру возможность с ней работать).
    Описания параметров:
    • integer $id - ID заявки
  • void sape_pr.advert.return_wm_improve(integer $id, string $reason)
    Отправить заявку на доработку вебмастеру.
    Описания параметров:
    • integer $id - ID заявки
    • string $reason - Причина
  • void sape_pr.advert.reject(integer $id, string $reason = null)
    Отклонение заявки вебмастером.
    Описания параметров:
    • integer $id - ID заявки
    • string $reason - Причина отклонения (null - стандартное сообщение об отклонении заявки вебмастером)
  • void sape_pr.advert.add_comment(integer $id, string $text, string $recipient = "myself")
    Добавляет комментарий к заявке.
    Описания параметров:
    • integer $id - ID заявки
    • string $text - Текст комментария
    • string $recipient - Кому предназначен комментарий. Возможные значения:
      • moderator - модератору
      • myself - себе
      • all - всем (вебмастеру, оптимизатору, модератору)
  • void sape_pr.advert.place(integer $id, string $url)
    Указание адреса размещения.
    Описания параметров:
    • integer $id - ID заявки
    • string $url - URL размещения
  • void sape_pr.advert.guarantee(integer $id)
    Гарантирование размещения заявки.
    Описания параметров:
    • integer $id - ID заявки
  • void sape_pr.advert.return_seo_rework(integer $id, string $reason)
    Отправка заявки на доработку оптимизатору.
    Описания параметров:
    • integer $id - ID заявки
    • string $reason - Текст причины
  • void sape_pr.advert.force_billing(integer $id)
    Назначение заявке досрочной выплаты всей стоимости (выплата средств происходит в течение суток).
    Описания параметров:
    • integer $id - ID заявки
  • struct sape_pr.advert.pack_offer(integer $pack_type, integer $project_id)
    Возвращает предложение по заданному пакету.
    Каждый элемент с ключом - ID площадки содержит данные по площадкам:
    • advert_indexed_percent - процент индексации заявок
    • ag_google - признак присутствия площадки в Google News
    • ag_yandex - признак присутствия площадки в Яндекс.Новостях
    • cy - тИЦ площадки
    • in_dmoz - признак присутствия площадки в DMOZ
    • in_yaca - признак присутствия площадки в Яндекс.Каталоге
    • price - цена заявки на площадке
    • url - URL площадки

    Описания параметров:
    • integer $pack_type - Тип пакета:
      • 1 - "Новостной удар" (формат заявок - ссылка в новости)
      • 2 - "Тематика" (формат заявок - обзор)
    • integer $project_id - ID проекта
  • array sape_pr.advert.pack_buy(integer $pack_type, integer $project_id, struct $params)
    Покупает пакет заявок. Возвращает массив строк - ID заявок.
    Описания параметров:
    • integer $pack_type - Тип пакета:
      • 1 - "Новостной удар" (формат заявок - ссылка в новости)
      • 2 - "Тематика" (формат заявок - обзор)
    • integer $project_id - ID проекта
    • struct $params - Параметры создания заявок:
      • см. описание в advert.create
      • исключение: "text" не задаётся; в качестве текста задания подбирается ссылка с наименее используемым анкором проекта
  • array sape_pr.social.filter_values(string $field, integer $sn, string $country = null)
    Возможные значения таргетинга.
    Используются значения, а не ключи массива.
    Описания параметров:
    • string $field - Поле фильтрации: gender, marital_status, country, city
    • integer $sn - Соцсеть: 1 - vk, 2 - fb, 3 - g+, 4 - mailru
    • string $country - Страна (необходима для выборки городов)
  • integer sape_pr.social.nb_profiles(integer $sn, struct $param)
    Кол-во пользователей подходящих под параметры таргетинга.
    Параметры таргетинга см. в social.create.
    Описания параметров:
    • integer $sn - Соцсеть: 1 - vk, 2 - fb, 3 - g+, 4 - mailru
    • struct $param - Параметры заявки
  • integer sape_pr.social.create(integer $type, integer $project_id, struct $param)
    Создание социальной заявки. Возвращает ID созданной заявки.
    Описания параметров:
    • integer $type - Тип размещения; возможные типы:
      • 2 - Share / Ссылка на стене
      • 4 - Crowd / Ссылка из обсуждения
    • integer $project_id - ID проекта
    • struct $param - Параметры заявки:
      Если $type == 2:
      • sn - соцсеть. 1: vk, 2: fb, 3: g+, 4: mailru
      • url - URL страницы
      • nb_likes - кол-во лайков/постов/пользователей
      • daily_limit - ограничение в день
      • text - текст поста
      • min_age - минимальный возраст
      • max_age - максимальный возраст
      • gender - пол (см. описание social.filter_values)
      • marital_status - семейное положение (см. описание social.filter_values)
      • country - страна (см. описание social.filter_values)
      • city - город (см. описание social.filter_values)
      • min_friends_count - минимальное кол-во друзей
      • max_friends_count - максимальное кол-во друзей
      Если $type == 4:
      • url - URL страницы
      • nb_likes - кол-во постов
      • sn - тип размещения: 5 (по умолчанию) - любое, 6 - Ответы@Mail.Ru, 7 - форумы и комментарии к блогам
      • is_concrete_url - признак, требовать ли от исполнителя строгого размещения заданного в заявке URL-а; иначе (по умолчанию) исполнитель размещает любой URL, найденный в домене, вырезанном из заданного оптимизатором URL-а
  • struct sape_pr.social.get(integer $id)
    Получение параметров заявки (не включает данные о выполнениях).
    Описание возвращаемой структуры: project.social.
    Описания параметров:
    • integer $id - ID заявки
  • void sape_pr.social.cancel(integer $id)
    Отмена заявки оптимизатором.
    Описания параметров:
    • integer $id - ID заявки
  • array sape_pr.autobuyer.index(struct $filter = [])
    Список авторежимов пользователя.
    Каждый элемент содержит:
    • id - ID авторежима
    • project_id - ID проекта
    • name - название
    • budget - бюджет
    • created_at - дата создания

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • id - ID авторежима
      • project_id - ID проекта
  • array sape_pr.autobuyer.anchors(integer $id)
    Список URL-ов и анкоров, подключенных к авторежиму.
    Каждый элемент содержит:
    • anchor_id - ID анкора
    • url_id - ID URL-а
    • url - текст URL-а
    • text - текст анкора
    • budget - бюджет на анкор (если задан)
    • nb_adverts_max - максимальное количество ссылок на анкор (если задано)

    Описания параметров:
    • integer $id - ID авторежима
  • integer sape_pr.autobuyer.create(struct $params, struct $anchor_data, boolean $start = true)
    Создаёт новый авторежим и возвращает его ID.
    Бюджет должен быть задан для проекта ($params) ИЛИ для анкоров ($anchor_data).
    Описания параметров:
    • struct $params - Параметры создания авторежима:
      • project_id - ID проекта
      • name - название авторежима
      • filter_type - тип фильтра
      • filter_id - ID фильтра
      • mode - режим (0 - полуавтоматический, 1 - автоматический)
      • period - период закупки (0 - единоразово, 30 - ежемесячно, 90 - 3 месяца, 180 - полгода)
      • adverts_per_day - максимальное кол-во заявок в день (опционально)
      • nb_review_links - кол-во ссылок для обзора (по умолчанию 3)
      • budget - бюджет авторежима
      • payment_type - тип оплаты (0 - сразу, 1 - в рассрочку)
      • credit_period - срок рассрочки (90, 180)
      • comment - комментарий к создаваемым заявкам (опционально)
    • struct $anchor_data - Анкоры авторежима; ключами является ID анкора, а значениями - массив параметров:
      • budget - бюджет на анкор
      • nb_adverts_max - максимальное кол-во ссылок
    • boolean $start - Запустить ли сразу созданный авторежим
  • void sape_pr.autobuyer.stop(integer $id)
    Остановить авторежим.
    Описания параметров:
    • integer $id - ID авторежима
  • void sape_pr.autobuyer.start(integer $id)
    Запустить авторежим.
    Описания параметров:
    • integer $id - ID авторежима
  • array sape_pr.autobuyer.stat(integer $id)
    Статистика по авторежиму.
    Описания параметров:
    • integer $id - ID авторежима
  • array sape_pr.comment.index(struct $filter = [], integer $page = 1, integer $per_page = 10)
    Возвращает массив комментариев.
    Каждый элемент содержит:
    • id - ID комментария
    • advert_id - ID заявки
    • author - автор комментария
    • text - комментарий
    • created_at - датавремя создания
    • is_read - просмотрен ли комментарий

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • advert_id - массив ID заявок
      • site_id - массив ID сайтов
      • project_id - массив ID проектов
      • read_state - выводить прочитанные (read) или непрочитанные (unread)
      • created_since - датавремя "с" в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
      • created_till - датавремя "по" в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • void sape_pr.comment.read(array $ids = [])
    Отметить комментарии как прочитанные.
    Описания параметров:
    • array $ids - Список ID комментариев (пустой массив - все комментарии)
  • float sape_pr.billing.money_hold()
    Прогнозируемый баланс по всем заявкам пользователя.
  • array sape_pr.twitter.account.search(struct $filter, integer $page = 1, integer $per_page = 500, struct $order = null)
    Поиск твит-аккаунтов.
    Для каждого сайта будет возвращен массив со следующими параметрами:
    • id - ID твит-аккаунта
    • user_id - ID вебмастера
    • name - название
    • screen_name - screen name
    • followers_count - количество фолловеров (кто подписан на данный аккаунт)
    • friends_count - количество друзей (на кого подписан данный аккаунт)
    • statuses_count - количество твитов у данного аккаунта
    • price_link - цена размещения
    • pr - Google Page Rank

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • id - ID твит-аккаунта
      • user_id - ID вебмастера
      • name - название
      • screen_name - screen name
      • followers_from - Минимальное количество фолловеров (кто подписан на данный аккаунт)
      • followers_to - максимальное количество фолловеров (кто подписан на данный аккаунт)
      • friends_from - минимальное количество друзей (на кого подписан данный аккаунт)
      • friends_to - максимальное количество друзей (на кого подписан данный аккаунт)
      • price_from - минимальная цена размещения
      • price_to - максимальная цена размещения
      • pr_from - минимальный Google Page Rank
      • pr_to - максимальный Google Page Rank
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
    • struct $order - Массив полей для сортировки по ним списка найденных твит-аккаунтов (1 - по возрастанию, -1 - по убыванию); возможные поля (ключи массива) для сортировки:
      • id
      • user_id
      • name
      • screen_name
      • followers_count
      • friends_count
      • statuses_count
      • price_link
      • pr
  • boolean sape_pr.twitter.advert.send_wm(integer $id)
    Отправить веб-мастеру.
    Описания параметров:
    • integer $id - ID заявки
  • integer sape_pr.twitter.advert.create(string $type, integer $project_id, integer $twaccount_id, struct $param)
    Создаёт твит-заявку.
    Возвращает ID в случае успеха и false в случае ошибки.
    Описания параметров:
    • string $type - Формат размещения заявки (только link)
    • integer $project_id - ID проекта
    • integer $twaccount_id - ID аккаунта Twitter
    • struct $param - Параметры для создания заявки:
      • url - URL для указания в заявке
      • text - Текст заявки
      • duplicate_create - Разрешить создавать дубликаты
      • max_price - максимальная цена покупки (необязательный параметр)
  • array sape_pr.twitter.advert.get(integer $id)
    Получение данных твит-заявки по её id.
    Массив возвращаемых полей:
    • id - ID заявки
    • type - тип ссылки (link, retweet)
    • status - статус заявки
    • tw_account_id - ID твит-аккаунта
    • price - цена
    • text - текст в теле твита
    • url - ссылка в теле твита
    • placement_url - адрес размещения
    • status_at - время смены статуса
    • placed_at - время размещения
    • created_at - время создания

    Описания параметров:
    • integer $id - ID твит-заявки
  • bool sape_pr.twitter.advert.approve(integer $id)
    Одобрить заявку со стороны оптимизатора.
    Описания параметров:
    • integer $id - ID твит-заявки
  • boolean sape_pr.twitter.advert.cancel(integer $id)
    Отменить заявку со стороны оптимизатора.
    Описания параметров:
    • integer $id - ID твит-заявки
  • boolean sape_pr.twitter.advert.add_comment(integer $id, string $text)
    Добавить комментарий для заявки.
    Описания параметров:
    • integer $id - ID твит-заявки
    • string $text - Текст комментария
  • array sape_pr.twitter.advert.get_comments(integer $id)
    Получить комментарии для заявки.
    Описания параметров:
    • integer $id - ID твит-заявки
  • array sape_pr.blacklist.seo.get(integer $project_id = null)
    Возвращает список площадок, занесённых в чёрный список проекта или ГБЛ:
    • ID площадки => URL площадки

    Описания параметров:
    • integer $project_id - ID проекта (null - площадки из ГБЛ)
  • integer sape_pr.blacklist.seo.add(array $site_urls_or_ids, integer $project_id = null)
    Добавляет площадки в чёрный список проекта или ГБЛ.
    Возвращает количество добавленных площадок.
    Описания параметров:
    • array $site_urls_or_ids - Массив Url-ов или ID площадок
    • integer $project_id - ID проекта (null - площадки добавляются в ГБЛ)
  • integer sape_pr.blacklist.seo.delete(array $site_urls_or_ids, integer $project_id = null)
    Удаляет площадки из чёрного списка проекта или ГБЛ.
    Возвращает количество удаленных площадок.
    Описания параметров:
    • array $site_urls_or_ids - Массив Url-ов или ID площадок
    • integer $project_id - ID проекта (null - площадки удаляются из ГБЛ)
  • void sape_pr.blacklist.seo.delete_all(integer $project_id = null)
    Удалить все площадки из черного списка или ГБЛ.
    Описания параметров:
    • integer $project_id - ID проекта (null - очищается ГБЛ)
  • array sape_pr.blacklist.wm.get(integer $site_id = null)
    Возвращает список доменов, занесённых в чёрный список площадки или ГБЛ.
    Описания параметров:
    • integer $site_id - ID площадки (null - возвращаются домены из ГБЛ)
  • integer sape_pr.blacklist.wm.add(array $domains_or_urls, integer $site_id = null)
    Добавляет домены в чёрный список площадки или ГБЛ.
    Возвращает количество добавленных доменов.
    Описания параметров:
    • array $domains_or_urls - Массив доменов или URL-ов, содержащих добавляемые в БЛ домены
    • integer $site_id - ID площадки (null - домены добавляются в ГБЛ)
  • integer sape_pr.blacklist.wm.delete(array $domains_or_urls, integer $site_id = null)
    Удаляет домены из чёрного списка площадки или ГБЛ.
    Возвращает количество удалённых доменов.
    Описания параметров:
    • array $domains_or_urls - Массив доменов или URL-ов, содержащих удаляемые из БЛ домены
    • integer $site_id - ID площадки (null - домены удаляются из ГБЛ)
  • void sape_pr.blacklist.wm.delete_all(integer $site_id = null)
    Удалить все домены из черного списка площадки или ГБЛ.
    Описания параметров:
    • integer $site_id - ID площадки (null - очищается ГБЛ)
  • struct sape_pr.whitelist.get_default()
    Получить раздел избранного по-умолчанию:
    • id - ID раздела избранного
    • name - Название раздела избранного
  • array sape_pr.whitelist.get_all()
    Получить список всех разделов избранного:
    • ID раздела => название
  • integer sape_pr.whitelist.create(string $name)
    Создаёт раздел избранного и возвращает его ID.
    Описания параметров:
    • string $name - Название раздела избранного
  • void sape_pr.whitelist.clear(integer $id = null)
    Очистить раздел избранного (удалить все площадки из раздела).
    Описания параметров:
    • integer $id - ID раздела избранного (null - берется раздел избранного по-умолчанию)
  • void sape_pr.whitelist.delete(integer $id)
    Удалить раздел избранного.
    Описания параметров:
    • integer $id - ID раздела избранного
  • void sape_pr.whitelist.rename(integer $id, string $name)
    Переименовать раздел избранного.
    Описания параметров:
    • integer $id - ID раздела избранного
    • string $name - Новое имя раздела избранного
  • array sape_pr.whitelist.get_sites(integer $list_id = null)
    Возвращает список площадок, добавленных в раздел избранного:
    • ID площадки => URL площадки

    Описания параметров:
    • integer $list_id - ID раздела избранного (null - берется раздел избранного по-умолчанию)
  • integer sape_pr.whitelist.add_sites(array $site_urls_or_ids, integer $list_id = null)
    Добавляет площадки в раздел избранного.
    Возвращает количество добавленных площадок.
    Описания параметров:
    • array $site_urls_or_ids - Массив Url-ов или ID площадок
    • integer $list_id - ID раздела избранного (null - берется раздел избранного по-умолчанию)
  • integer sape_pr.whitelist.remove_sites(array $site_urls_or_ids, integer $list_id = null)
    Удаляет площадки из раздела избранного.
    Возвращает количество удаленных площадок.
    Описания параметров:
    • array $site_urls_or_ids - Массив Url-ов или ID площадок
    • integer $list_id - ID раздела избранного (null - берется раздел избранного по-умолчанию)
  • integer sape_pr.article.create(integer $project_id, struct $params)
    Создаёт статью. Возвращает ID созданной статьи.
    Описания параметров:
    • integer $project_id - ID проекта
    • struct $params - Параметры создания статьи:
      Обязательные:
      • title - Заголовок статьи
      • body - Html текст статьи
      • meta_title - META Title
      Необязательные:
      • no_comments - Отключить комментирование
      • meta_keywords - META Keywords
      • meta_description - META Description
      • description - Описание
      • slug - Желаемый вид URL
      • snippet - Текст анонса
  • struct sape_pr.article.get(integer $id)
    Получить данные по статье:
    • id - ID статьи
    • status - Статус
    • project_id - Проект
    • user_id - Владелец
    • links - Ссылки в статье
    • body - Html текст статьи
    • no_comments - Отключить комментирование
    • title - Заголовок статьи
    • meta_keywords - META Keywords
    • meta_title - META Title
    • meta_description - META Description
    • description - Описание
    • slug - Желаемый вид URL
    • snippet - Текст анонса
    • is_archived - Статья в архиве или нет

    Описания параметров:
    • integer $id - ID статьи
  • array sape_pr.article.get_list(struct $filter = null, integer $page = 1, integer $per_page = 500)
    Получить список статей по фильтру.
    Каждый элемент содержит:
    • id - ID статьи
    • status - Статус
    • project_id - Проект
    • user_id - Владелец
    • links - Ссылки в статье
    • body - Html текст статьи
    • no_comments - Отключить комментирование
    • title - Заголовок статьи
    • meta_keywords - META Keywords
    • meta_title - META Title
    • meta_description - META Description
    • description - Описание
    • slug - Желаемый вид URL
    • snippet - Текст анонса
    • is_archived - Статья в архиве или нет

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • ids - список id статей
      • project_id - ID проекта
      • statuses - список статусов
      • created_from - дата начала диапазона по времени создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
      • created_to - дата конца диапазона по времени создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
      Возможные коды статусов:
      • 0 - черновик
      • 1 - на модерации
      • 2 - отклонена
      • 3 - промодерирована
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • void sape_pr.article.update(integer $id, struct $params)
    Обновить параметры статьи.
    Описания параметров:
    • integer $id - ID статьи
    • struct $params - Возможные парметры обновления:
      • title - Заголовок статьи
      • body - Html текст статьи
      • meta_title - META Title
      • meta_keywords - META Keywords
      • no_comments - Отключить комментирование
      • meta_description - META Description
      • description - Описание
      • slug - Желаемый вид URL
      • snippet - Текст анонса
      • moderate - Отправить на модерацию
      • unmoderate - Вернуть из модерации
  • array sape_pr.article_order.get_categories(boolean $group = false)
    Получить список возможных тематических категорий.
    При отсутствии группировки результатом являтеся массив всех категорий вида:
    • ID категории => Название категории
    При наличии группировки результатом является массив групповых категорий с вложенными обычными категориями вида:
    • Название группы => подмассив:
      • ID категории => Название категории

    Описания параметров:
    • boolean $group - Группировать ли категории
  • integer sape_pr.article_order.create(integer $project_id, struct $data)
    Создать заказ на статью для проекта.
    Описания параметров:
    • integer $project_id - ID проекта
    • struct $data - Параметры создаваемой статьи:
      • title - Название статьи
      • description - Описание требований
      • keywords - Ключевые слова
        • title - Ключевое слово
        • nof - Количество повторений
        • mod - Можно ли склонять слово
      • links - Ссылки, массив с элементами, каждый из которых содержит:
        • anchor - Анкор
        • url - Ссылка
        • mod - Можно ли склонять анкор
      • categories_list - Массив ID тематических категорий
  • struct sape_pr.article_order.get(integer $id)
    Получить заказ статьи.
    Данные по заказу статьи содержат:
    • id - ID статьи
    • status - Статус
    • status_name - Строковое описание статуса
    • user_id - Владелец заказа
    • project_id - Проект заказа
    • article_id - ID сохраненной статьи
    • title - Название статьи
    • description - Описание требований
    • keywords - Ключевые слова:
      • title - Ключевое слово
      • nof - Количество повторений
      • mod' - Можно ли склонять слово
    • links - Ссылки, массив с элементами, каждый из которых содержит:
      • anchor - Анкор
      • url - Ссылка
      • mod - Можно ли склонять анкор
    • categories_list - Массив ID тематических категорий
    • price - Цена заказа
    • decline_reason - Причина отклонения заказа
    • article_written - Написанная статья:
      • header - Заголовок
      • announcement - Текста анонса статьи
      • article_text - Текст статьи
      • title - META Title
      • keywords - META Keywords
      • description - META Description

    Описания параметров:
    • integer $id - ID статьи
  • array sape_pr.article_order.get_list(struct $filter = null, integer $page = 1, integer $per_page = 500)
    Получить список заказов статей по фильтру.
    Возвращает массив, каждый элемент которого повторяет структуру ответа article_order.get.
    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • ids - список id статей
      • project_id - проект
      • statuses - список статусов
      • created_from - дата начала диапазона по времени создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
      • created_to - дата конца диапазона по времени создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • void sape_pr.article_order.cancel(integer $id)
    Отменить заказ.
    Описания параметров:
    • integer $id - ID заказа
  • void sape_pr.article_order.activate(integer $id)
    Активировать заказ.
    Описания параметров:
    • integer $id - ID заказа
  • void sape_pr.article_order.do_correct(integer $id)
    Уточнить заказ.
    Описания параметров:
    • integer $id - ID заказа
  • void sape_pr.article_order.decline(integer $id, string $reason)
    Отклонить заказ.
    Описания параметров:
    • integer $id - ID заказа
    • string $reason - Причина отклонения заказа
  • void sape_pr.article_order.approve(integer $id)
    Утвердить заказ.
    Описания параметров:
    • integer $id - ID заказа

Ограничения вызовов функций

Базовое ограничение: допустимо вызывать любые функции в сумме не больше 60 раз в течение 1 секунды.

Ограничения по функциям (в пределах заданного промежутка времени):

  • sape_pr.advert.place (15 секунд):
    • количество вызовов — 5
  • sape_pr.comment.index (1 час):
    • количество вызовов — 15
  • sape_pr.project.adverts (1 минута):
    • суммарное время выполнения — 60 секунд
    • не более 2 параллельных вызовов
  • sape_pr.project.finance_stats (1 день):
    • суммарное время выполнения — 200 секунд
    • не более 1 параллельного вызова
  • sape_pr.project.index (1 час):
    • суммарное время выполнения — 25 секунд
    • не более 1 параллельного вызова
  • sape_pr.site.adverts (1 минута):
    • суммарное время выполнения — 60 секунд
    • не более 2 параллельных вызовов
  • sape_pr.site.finance_stats (1 день):
    • суммарное время выполнения — 200 секунд
    • не более 1 параллельного вызова
  • sape_pr.site.ownlist (2 часа):
    • суммарное время выполнения — 80 секунд
    • не более 1 параллельного вызова
  • sape_pr.site.search (15 секунд):
    • количество вызовов — 1
  • sape_pr.social.filter_values (1 минута):
    • количество вызовов — 10

Список кодов и расшифровок исключений

Ниже представлен список исключений, которые могут возникнуть в процессе работы с функционалом API.PR.SAPE.RU. Данный список всегда актуален и время от времени меняется.
Возникающее в процессе работы исключение может в зависимости от ситуации содержать в дополнение к стандартному сообщению более подробную информацию (указывается в скобках).
В случае возникновения исключения, код которого здесь не указан, обратитесь в службу технической поддержки.

Код Описание
100200022 Нельзя получить фин. статистику по заявкам: некорректная группировка периодов
100200042 Нельзя получить фин. статистику по стероидам: некорректная группировка периодов
100300021 Проверка гостевого доступа: нет прав для выполнения операции
101200002 Нельзя перенести объект: перенос возможен только на другого пользователя
101400001 Извлечение ссылок: не удалось найти ни одной ссылки в переданном HTML
101400021 Извлечение ссылок: не удалось найти ни одного URL-а в переданном HTML
101400041 Извлечение ссылок: не удалось найти ни одной ссылки в переданном списке
102000001 Загрузка статьи из TXT-файла: не удалось загрузить файл
102000021 Загрузка статей из ZIP-архива: не удалось загрузить архив
102000022 Загрузка статей из ZIP-архива: не удалось разархивировать
102000023 Загрузка статей из ZIP-архива: архив не содержит файлов с расширением .txt
102000042 Чтение файла со статьёй: не задано обязательное поле
102700061 Проверка задания заявки: нет ни одной корректной ссылки
102700062 Проверка задания заявки: URL "site.ru" недопустим
102700063 Проверка задания заявки: не удаётся открыть страницу по URL-у из задания (страница не найдена или доступ к ней ограничен)
102700081 Проверка площадки для размещения: площадка не размещает заявки данного формата
102700082 Проверка площадки для размещения: нельзя создать заявку на собственную площадку
102700083 Проверка площадки для размещения: площадка не принимает новые заявки
102700084 Проверка площадки для размещения: в данный момент на площадке уже размещается максимальное количество заявок
102700085 Проверка площадки для размещения: стоимость размещения превышает разрешённую
102700086 Проверка площадки для размещения: площадка принимает заявки только с размещением ссылок вне текста новости
102700087 Проверка площадки для размещения: превышен бюджет проекта
102700101 Проверка заявки на дубликаты: заявка с такими же ссылками уже есть на другой площадке
102700121 Проверка анкоров ссылок заявки: превышен лимит использования анкора
102700122 Проверка анкоров ссылок заявки: у всех анкоров превышены лимиты использования
102700141 Проверка URL-ов ссылок заявки: присутствует некорректный URL
102700161 Ошибка создания заявки: статья не промодерирована
102700162 Ошибка создания заявки: статья находится в архиве
102700163 Ошибка создания заявки: статья не существует
102700181 Ошибка создания заявки: не указано место размещения (в тексте, вне текста)
102700201 Ошибка создания заявки: у оптимизатора нет права на покупку заявки в рассрочку
102700202 Ошибка создания заявки: площадка не принимает заявки в рассрочку
102700203 Ошибка создания заявки: некорректный тип оплаты
102700204 Ошибка создания заявки: недостаточно средств для блокировки
102700221 Ошибка создания заявки: не удалось найти проект
102700222 Ошибка создания заявки: проект находится в архиве
102700242 Ошибка создания заявки: не удалось найти площадку
102700261 Ошибка создания заявки: в ссылках заявки присутствуют запрещённые слова
102700262 Ошибка создания заявки: бюджет проекта реализован
102700281 Ошибка создания заявки: опция "любой анкор" недоступна
102700301 Установка ссылок для заявки: домен URL-а ссылки находится в чёрном списке на площадке вебмастера
102800001 Ошибка создания статьи: не удалось найти проект
102800002 Ошибка создания статьи: проект находится в архиве
102800021 Ошибка обновления статьи: не удалось найти статью для данного оптимизатора
102800041 Ошибка создания статьи: нет ни одной корректной ссылки
102800042 Ошибка создания статьи: указаны некорректные данные
102800061 Ошибка обновления статьи: нет ни одной корректной ссылки
102800062 Ошибка обновления статьи: указаны некорректные данные
103000001 Проверка баланса: недостаточно средств для блокировки
103000021 Проверка твиттер-аккаунта для размещения: твиттер-аккаунт не принимает новые твит-заявки
103000022 Проверка твиттер-аккаунта для размещения: твиттер-аккаунт не размещает заявки данного формата
103000023 Проверка твиттер-аккаунта для размещения: нельзя создать твит-заявку на собственном твиттер-аккаунте
103000024 Проверка твиттер-аккаунта для размещения: стоимость размещения превышает разрешённую
103000041 Ошибка создания твит-заявки: не удалось найти проект
103000042 Ошибка создания твит-заявки: проект находится в архиве
103000061 Ошибка создания твит-заявки: задан некорректный URL
103000062 Ошибка создания твит-заявки: в тексте твита не должно быть ни одного URL
103000063 Ошибка создания твит-заявки: URL находится в системном ГБЛ
103000064 Ошибка создания твит-заявки: Домен URL-а находится в твиттер-блэклисте
103000081 Ошибка создания твит-заявки: длина текста твита превышает допустимую
103000101 Ошибка создания твит-заявки: переданы некорректные ID твиттер-аккаунтов
103000102 Ошибка создания твит-заявки: не удалось найти твиттер-аккаунт
103000121 Ошибка создания твит-заявки: бюджет проекта реализован
103000122 Ошибка создания твит-заявки: в тексте твита присутствуют запрещённые слова
103000123 Ошибка создания твит-заявки: попытка создания дубликата ссылки для того же твит-аккаунта
103100001 Нельзя создать заказ статьи: не удалось найти проект
103100002 Нельзя создать заказ статьи: проект находится в архиве
103100003 Нельзя создать заказ статьи: указаны некорректные данные
103100005 Нельзя создать заказ статьи: заявка не найдена
103100006 Нельзя создать заказ статьи: заявка уже имеет заказ
103200001 Нельзя подобрать анкор: проект не содержит ни одного активного анкора
103800001 Ошибка валидации схемы URL-а: некорректный URL
103800002 Ошибка валидации схемы URL-а: недопустимая схема
103800021 Ошибка валидации URL-а: площадка недоступна
103800022 Ошибка валидации URL-а: площадка находится в системном ГБЛ
103800023 Ошибка валидации URL-а: площадка уже зарегистрирована в системе
103800024 Ошибка валидации URL-а: запрос на добавление площадки уже существует
103800041 Не удалось получить ID домена: Некорректное имя домена
120100081 Нельзя гарантировать размещение заявки: размещение заявки уже было гарантировано
120100082 Нельзя гарантировать размещение заявки: заявка находится в некорректном статусе
120100083 Нельзя гарантировать размещение заявки: у оптимизатора ещё есть время для отмены заявки
120100101 Нельзя досрочно оплатить заявку: некорректный статус
120100121 Нельзя подтвердить создание заявки: заявка не находится в статусе требования подтверждения
120100141 Нельзя указать адрес размещения: некорректный статус
120100181 Нельзя отправить заявку на уточнение оптимизатору: только модератор может выполнить операцию для данной заявки
120100182 Нельзя отправить заявку на уточнение оптимизатору: заявка не находится на размещении/доработке у вебмастера
120100202 Нельзя обработать заявку: заявка не находится в статусе проверки размещения
120100204 Нельзя обработать заявку: размещение данной заявки проверяется модератором
120100222 Нельзя отменить заявку: заявка находится на размещении у вебмастера недостаточно долго
120100223 Нельзя отменить заявку: заявка находится на доработке у вебмастера недостаточно долго
120100224 Нельзя отменить заявку: размещение заявки гарантировано
120100225 Нельзя отменить заявку: заявка ожидает индексации недостаточно долго
120100226 Нельзя отменить заявку: некорректный статус
120100241 Нельзя произвести VIP-отмену заявки: заявка не утверждена
120100242 Нельзя произвести VIP-отмену заявки: заявка куплена не в рассрочку
120100261 Нельзя отклонить заявку: некорректный статус
120100262 Нельзя отклонить заявку: были выплаты по рассрочке
120100281 Нельзя отменить заявку из-за долгого нахождения в ошибке: нет ошибки размещения
120100283 Нельзя отменить заявку из-за долгого нахождения в ошибке: некорректный статус
120100301 Нельзя определить заявку к снятию: заявка не утверждена
120100321 Нельзя снять заявку: заявка не определена к снятию
120100322 Нельзя снять заявку: заявка не оплачена
120100323 Нельзя снять заявку: есть неоплаченный стероид снятия
120100324 Нельзя снять заявку: оплаченный стероид снятия уже отмечен применённым
120100381 Нельзя утвердить заявку: некорректный статус
120100442 Нельзя отклонить заявку: некорректный статус
120100443 Нельзя отклонить заявку: были выплаты по рассрочке
120100445 Нельзя отклонить заявку: были выплаты
120100581 Нельзя сделать заказ текста для заявки: заказ уже существует
120100582 Нельзя сделать заказ текста для заявки: заявка в неверном статусе
120100583 Нельзя сделать заказ текста для заявки: тип заявки не предполагает заказ контента
120100584 Нельзя сделать заказ текста для заявки: текущий пользователь не является вебмастером-владельцем заявки; гостевой доступ не поддерживается
120100641 Нельзя отменить снятие заявки: заявка не определена к снятию
120100643 Нельзя отменить снятие заявки: оплата услуги снятия уже была одобрена
120100721 Нельзя создать стероид изменения ссылок для заявки: операция не поддерживается для заявок формата "статья"
120100722 Нельзя создать стероид изменения ссылок для заявки: заявка не утверждена
120100723 Нельзя создать стероид изменения ссылок для заявки: заявка находится в ошибке размещения
120100724 Нельзя создать стероид изменения ссылок для заявки: на площадке запрещено изменение ссылок
120100725 Нельзя создать стероид изменения ссылок для заявки: услуга для данной заявки уже была заказана
120100761 Нельзя отменить стероид изменения ссылок для заявки: операция возможна только для ещё не одобренного стероида (при наличии)
120100762 Нельзя отменить стероид изменения ссылок для заявки: стероид уже виден вебмастеру, но недостаточно долго
120100781 Нельзя отклонить стероид изменения ссылок для заявки: операция возможна только для ещё не одобренного стероида (при наличии)
120100821 Нельзя отклонить стероид изменения ссылок для заявки: задан слишком короткий текст причины отклонения
120100841 Нельзя создать черновики новых ссылок заявки: не заданы параметры черновиков
120100842 Нельзя создать черновики новых ссылок заявки: заявка не найдена
120100843 Нельзя создать черновик новой ссылки заявки: исходная ссылка не найдена в базе
120100844 Нельзя создать черновик новой ссылки заявки: исходная ссылка неактивна
120100846 Нельзя создать черновик новой ссылки заявки: заданные исходные ссылки принадлежат чужой заявке
120100847 Нельзя создать черновик новой ссылки заявки: на площадке запрещено изменение URL-а
120100848 Нельзя создать черновик новой ссылки заявки: на площадке запрещено изменение анкора
120100849 Нельзя создать черновик новой ссылки заявки: не задано ни одного нового URL-а или анкора
120100862 Нельзя отклонить заявку: не указана причина
120200041 Слишком короткий комментарий к заявке
120200042 Комментарий к заявке превышает максимальную длину
120300001 Нельзя удалить URL: URL используется в твит-заявках
120300002 Нельзя удалить URL: есть использующиеся анкоры
120300003 Нельзя удалить URL: URL используется в социальных заявках
120300021 URL не задан
120300022 URL не содержит указание протокола
120300023 Некорректный ID проекта
120300041 Некорректный URL
120300061 URL находится в системном ГБЛ
120400001 Нельзя удалить анкор: анкор используется в ссылках заявок
120400002 Нельзя удалить анкор: анкор используется в авторежимах
120400003 Нельзя удалить анкор: анкор используется в твит-заявках
120400004 Нельзя удалить анкор: анкор используется в социальных заявках
120400022 Некорректный ID URL-а
120400023 Некорректный текст анкора
120400024 Некорректный текст анкора: в тексте присутствуют запрещённые слова
120400041 Нельзя архивировать анкор: данный анкор является единственным в активном авторежиме
120400061 Не могу добавить анкор: слишком длинный текст анкора
120500021 Нельзя запустить авторежим: не задано ни одного анкора
120700022 Нельзя архивировать проект: на проекте есть заявки в работе
120700023 Нельзя архивировать проект: проект создан в Wizard.Sape
120700041 Нельзя купить пакет: не определён продвигаемый в проекте домен
120700042 Нельзя купить пакет: проект архивирован
120700043 Нельзя купить пакет: проект создан в системе Wizard.Sape
120700045 Нельзя купить пакет: некорректный тип пакета
120700046 Нельзя купить пакет: для домена проекта не определена тематика; задайте тематику проекта вручную в его настройках
120700047 Нельзя купить пакет: у проекта нет ни одного анкора для твитов или социальных заявок
121200001 Нельзя отправить твит-заявку вебмастеру: твит-заявка не находится на размещении
121200021 Нельзя отправить твит-заявку в работу: некорректный статус
121200041 Нельзя разместить твит-заявку: твит-заявка не находится в работе
121200061 Нельзя одобрить твит-заявку: твит-заявка не находится на проверке размещения
121200081 Нельзя отклонить твит-заявку: некорректный статус
121200121 Нельзя отменить твит-заявку: некорректный статус
121200181 Нельзя разместить твит-заявку: некорректный адрес размещения
121500001 Нельзя удалить статью: статья используется в заявках
121700001 Нельзя отменить заказ: некорректный статус
121700021 Нельзя активировать заказ: некорректный статус
121700041 Нельзя отправить на уточнение заказ : некорректный статус
121700061 Нельзя уточнить заказ: некорректный статус
121700081 Нельзя взять в работу заказ: некорректный статус
121700101 Нельзя выполнить заказ: некорректный статус
121700121 Нельзя отклонить заказ: некорректный статус
121700141 Нельзя подтвердить заказ: некорректный статус
121900001 Нельзя остановить социальную заявку: заявка уже обработана
121900041 Нельзя создать социальную заявку: заданы некорректные параметры
121900042 Нельзя создать социальную заявку: запрошено слишком много лайков/постов
121900043 Нельзя создать социальную заявку: текст содержит запрещённые слова
121900049 Нельзя создать социальную заявку: не задана социальная сеть
121900050 Нельзя создать социальную заявку: задана некорректная социальная сеть
121900051 Нельзя создать социальную заявку: не задан тип размещения
121900052 Нельзя создать социальную заявку: задан некорректный тип размещения
121900085 Нельзя добавить выполнение: слишком длинный уникальный ID выполнения
122000001 Нельзя удалять последний раздел избранного
122000021 Раздел избранного с такими именем уже существует
122100001 Указанные площадки не найдены
122100002 Не указан раздел избранного
122200001 Нельзя создать твиттер-аккаунт: указанный screen_name аккаунта уже существует в системе
122200021 Нельзя изменить screen name у твиттер-аккаунта: screen name не задан
122200022 Нельзя изменить screen name у твиттер-аккаунта: задан тот же screen name, который уже установлен для данного твиттер-аккаунта
122200023 Нельзя изменить screen name у твиттер-аккаунта: аккаунт с заданным screen name уже существует в системе
122300022 Нельзя настроить авторежим социальных заявок: авторежим совершает закупку в данный момент
122300023 Нельзя настроить авторежим социальных заявок: не задано ни одной социальной сети, по которой должна производиться закупка
122300025 Нельзя настроить авторежим социальных заявок: задан слишком маленький бюджет
122300027 Нельзя настроить авторежим социальных заявок: минимальное количество друзей больше максимального
122300061 Нельзя создать авторежим социальных заявок: проект относится к системе Wizard.Sape
122500041 Нельзя создать авторежим твиттер заявок: проект относится к системе Wizard.Sape
122500061 Нельзя закупить твит-заявки: Нет подходящих твит-аккаунтов
122500062 Нельзя закупить твит-заявки: Нет анкоров
122500082 Нельзя настроить авторежим твиттер заявок: авторежим совершает закупку в данный момент
122500083 Нельзя настроить авторежим твиттер заявок: задан слишком маленький бюджет
122700041 Нельзя сохранить авторежим крауд-ссылок: проект относится к системе Wizard.Sape
122700042 Нельзя сохранить авторежим крауд-ссылок: задан слишком маленький бюджет
122700043 Нельзя сохранить авторежим крауд-ссылок: не задан домен
122700061 Нельзя настроить авторежим крауд-ссылок: авторежим совершает закупку в данный момент
122800001 Нельзя добавить instagram-аккаунт: слишком малое число подписчиков
122800011 Нельзя добавить instagram-аккаунт: аккаунт с таким screen name уже существует в системе
122800012 Нельзя добавить instagram-аккаунт: аккаунт с таким Instagram ID уже существует в системе
122900001 Нельзя перевести на размещение instagram-заявку: заявка в непригодном исходном статусе
122900021 Нельзя отправить на уточнение задания instagram-заявку: заявка не находится на размещении
122900041 Нельзя отправить на согласование instagram-заявку: заявка в непригодном исходном статусе
122900042 Нельзя отправить на согласование instagram-заявку: заявка не находится в работе
122900061 Нельзя отправить на доработку размещаемый материал instagram-заявки: заявка в непригодном исходном статусе
122900081 Нельзя отправить на доработку instagram-заявку с размещённым материалом: заявка в непригодном исходном статусе
122900101 Нельзя одобрить instagram-заявку: заявка не находилась на проверке размещения
122900121 Нельзя отклонить instagram-заявку от имени модератора: заявка находится в непригодном исходном статусе или оплачена
122900141 Нельзя отклонить instagram-заявку от имени оптимизатора: заявка находится в непригодном исходном статусе
122900142 Нельзя отклонить instagram-заявку от имени оптимизатора: заявка находится в работе
122900161 Нельзя отклонить instagram-заявку от имени вебмастера: заявка находится в непригодном исходном статусе
122900181 Нельзя отправить на доработку задания instagram-заявку: заявка не находится на размещении
122900182 Нельзя отправить на доработку задания instagram-заявку: заявка находится в работе
122900201 Нельзя разместить instagram-заявку: некорректный адрес размещения
122900281 Нельзя сохранить заявку: задано слишком большое число шагов выполнения
122900301 Нельзя принять заявку в работу: заявка находится в непригодном статусе
122900302 Нельзя принять заявку в работу: заявка уже находится в работе
122900321 Нельзя разместить instagram-заявку: заявка в непригодном исходном статусе
122900322 Нельзя разместить instagram-заявку: заявка не находится в работе
122900341 Нельзя добавить предлагаемый пост: превышен допустимый размер файла изображения
122900342 Нельзя добавить предлагаемый пост: не задан ни текст поста, ни изображение к нему
122900343 Нельзя добавить предлагаемый пост: задан неверный тип изображения
122900361 Нельзя закончить согласование заявки: заявка в непригодном исходном статусе
122900381 Ошибка проверки размещения: не задан URL размещения
122900382 Ошибка проверки размещения: нет доступа к странице размещения
122900384 Ошибка проверки размещения: screen name поста не соответствует screen name площадки
122900385 Ошибка проверки размещения: не найдено хэш-тегов или меншенов из задания
123000001 Проверка баланса: недостаточно средств для блокировки
123000021 Ошибка создания instagram-заявки: не удалось найти проект для данного оптимизатора
123000022 Ошибка создания instagram-заявки: проект находится в архиве
123000061 Проверка instagram-аккаунта для размещения: instagram-аккаунт не принимает новые твит-заявки
123000062 Проверка instagram-аккаунта для размещения: instagram-аккаунт не размещает заявки данного формата
123000063 Проверка instagram-аккаунта для размещения: нельзя создать instagram-заявку на собственном instagram-аккаунте
123000064 Проверка instagram-аккаунта для размещения: стоимость размещения превышает разрешённую
123000081 Ошибка создания instagram-заявки: бюджет проекта исчерпан
123000082 Ошибка создания instagram-заявки: в тексте задания присутствуют запрещённые слова
123000101 Ошибка создания instagram-заявки: переданы некорректные ID instagram-аккаунтов
123000102 Ошибка создания instagram-заявки: не удалось найти instagram-аккаунт
123100043 Нельзя выполнить закупку Instagram-заявок: заблокированные средства по заявкам составляют весь бюджет
123100044 Нельзя выполнить закупку Instagram-заявок: авторежим совершает закупку в данный момент
123100045 Нельзя выполнить закупку Instagram-заявок: авторежим не запущен
123100046 Нельзя выполнить закупку Instagram-заявок: проект относится к системе Wizard.Sape
123100047 Нельзя выполнить закупку Instagram-заявок: проект архивирован
123100048 Нельзя выполнить закупку Instagram-заявок: бюджет авторежима меньше минимальной цены заявки
123100061 Нельзя создать авторежим Instagram-заявок: проект относится к системе Wizard.Sape
123200002 Нельзя добавить изображение: превышен допустимый размер файла
123200003 Нельзя добавить изображение: задан неверный тип изображения
123300040 Ошибка добавления в корзину: такой элемент уже есть
250100006 Ошибка создания заявки: недостаточно средств для блокировки
250100010 Ошибка создания заявки: недостаточно средств, покупка заявки приведёт к SLEEP-у других заявок
250100011 Ошибка создания заявки: сервис загружен. Попробуйте произвести покупку снова через несколько минут.
250101305 Невозможно переблокировать средства для переноса заявки
250200010 Ошибка создания твит-заявки: недостаточно средств, покупка заявки приведёт к SLEEP-у других заявок
250200011 Ошибка создания твит-заявки: недостаточно средств для блокировки
250201305 Невозможно переблокировать средства для переноса твит-заявки
250300006 Недостаточно средств для блокировки
250300010 Недостаточно средств (контроль бюджета; покупка заказа приведёт к SLEEP-у)
250300011 Сервис биллинга загружен (обновляются балансы пользователей)
250301305 Невозможно переблокировать средства для переноса заказа
250600006 Ошибка создания стероида: недостаточно средств для блокировки
250600010 Ошибка создания стероида: недостаточно средств, покупка стероида приведёт к SLEEP-у заявок
250600011 Ошибка создания стероида: сервис загружен. Попробуйте произвести покупку снова через несколько минут.
250700010 Ошибка создания instagram-заявки: недостаточно средств, покупка заявки приведёт к SLEEP-у других заявок
250700011 Ошибка создания instagram-заявки: недостаточно средств для блокировки
250701305 Невозможно переблокировать средства для переноса заявки
1300100001 Не удалось найти проект: некорректный ID проекта или владелец
1300100021 Не удалось найти площадку: некорректный ID площадки или владелец
1300100041 Не удалось найти авторежим: некорректный ID авторежима или владелец
1300100061 Не удалось найти заявку: некорректный ID заявки или владелец
1300100081 Не удалось найти заявку на соц. сети: некорректный ID заявки на соц. сети или владелец
1300100101 Не удалось найти заказ кликов: некорректный ID заказа
1300100121 Не удалось найти твит-аккаунт: некорректный ID аккаунта или владелец
1300100141 Не удалось найти твит-заявку: некорректный ID твит-заявки или владелец
1300100161 Заданы некорректные настройки проекта
1300100181 Нельзя создать заявку формата "статья": не найдена статья
1300100201 Не удалось найти задание заявки: некорректный ID заявки или номер версии
1300100241 Нельзя создать твит-заявку: некорректный формат размещения
1300100242 Нельзя создать твит-заявку: не задан URL
1300100261 Не удалось найти заказ статьи: некорректный ID заказа или владелец
1300200001 Ошибка авторизации: неверный логин или пароль
1300300001 Нельзя запросить добавление новой площадки: заданы некорректные параметры площадки
1300300021 Ошибка поиска площадок: некорректный формат размещения
1300300041 Нельзя обновить площадку: заданы некорректные параметры площадки
1300400001 Ошибка проверки размещения заявки
1300500001 Нельзя создать авторежим: заданы некорректные параметры
1300800001 Нельзя создать твиттер-аккаунт: не указан GUID аккаунта
1300800002 Нельзя создать твиттер-аккаунт: указанный GUID аккаунта уже зарегистрирован в системе
1300800003 Нельзя создать твиттер-аккаунт: не указан screen_name аккаунта
1300800004 Нельзя создать твиттер-аккаунт: указанный screen_name аккаунта уже зарегистрирован в системе
1300800005 Нельзя создать твиттер-аккаунт: слишком длинный Rotapost ID
1300800021 Нельзя получить твиттер-аккаунт: некорректный тип идентификатора
1300800022 Не удалось найти твиттер-аккаунт: некорректный ID аккаунта
1300800041 Нельзя обновить твиттер-аккаунт: заданы некорректные параметры аккаунта
1301000001 Раздел избранного не найден
1301000021 Ошибка создания раздела избранного
1400300011 Нельзя создать социальную заявку: указан некорректный URL
1400300012 Нельзя создать социальную заявку: указано некорректное количество размещений
1400501100 Ошибка при обработке заказа контента: неверные входные данные
1400501200 Ошибка при обработке заказа контента: ошибка в биллинге
1400501400 Ошибка при обработке заказа контента: действие совершить невозможно