SAPE.RU XML-RPC

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

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

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

  • (int) sape.login((string) login,(string) token) — авторизация в системе, необходимо вызывать в начале каждой сессии. Далее при каждом следующем запросе нужно передавать все вернувшиеся cookie. Результатом выполнения функции является id пользователя. Для генерации токена для своего аккаунта перейдите на эту страницу.
  • (array) sape.get_user() — информация о пользователе:
    • login,
    • e-mail,
    • баланс,
    • число купленных ссылок,
    • число купленных ссылок в статусе ОК,
    • месячный бюджет,
    • месячный бюджет по статусу ОК,
    • расход сутки, расход неделя,
    • доход сутки, доход неделя,
    • партнёрка сутки, партнёрка неделя,
    • результат сутки, результат неделя.
  • (float) sape.get_balance() — текущий баланс пользователя, включая заблокированные средства.
  • (float) sape.get_balance_real() — доступный баланс пользователя.
  • (array) sape.get_balance_locks() — текущий баланс с детализацией блокировок. Результат содержит информацию по балансу:
    • available — Доступно к тратам ВСЕГО,
    • total — Баланс с блокировками ОБЩИЙ,
    • earned — Заработанные средства:
      • total — всего заработано,
      • autoTransfer — разрешены ли траты заработанных средств
    • bonus — Бонусы
    • blockedAndBudget — Блокировки и бюджеты,
    • budget — Бюджеты:
      • total — общая сумма бюджетов,
      • subsys — бюджеты по подсистемам:
        • SAPE — бюджет по системе Сапе-Ссылки,
        • ARTICLES — бюджет по системе Сапе-Статьи,
        • ...
    • blocked — Блокировки:
      • total — всего заблокировано,
      • promo — на промо-акции,
      • dox — непредоставление документов,
      • bonus — спонсорство,
      • out — заявки на вывод
      • subsys — блокировки по подсистемам:
        • SAPE — блокироки по системе Сапе-Ссылки,
        • WIZARD — блокироки по системе Сеовизард,
        • ...
  • (array) sape.get_bills((int) year[, (int) month = null[, (int) day = null[, (int) user_id = null]]]) — данные по датам зачисления/поступления денег в разрезе каждого счета, по умолчанию выводятся счета аккаунтов привязанных к юрлицу, если такая связь есть, если нужно получить счета по конкретному аккаунту, то необходимо установить параметр user_id, если user_id == true, то выводится информация по текущему юзеру. Каждый элемент массива содержит:
    • ID счета,
    • номер документа,
    • дата создания,
    • сумма,
    • дата поступления,
    • дата зачисления
  • (array) sape.get_sites([(array)opts]) — список сайтов пользователя.
    opts может содержать следующие параметры —
    • (bool) show_days_to_recheck — показать количество дней до возможности запустить переиндексацию.,
    • (bool) show_block_display_params — показать параметры блочного отображения ссылок,
    • (bool) show_traf_pages — показать количество трафиковых страниц,
    • (int) pn = 0,
    • (int) ps = 0.
    Структура ответа:
    • id — ID сайта,
    • url — УРЛ,
    • cy — CY,
    • pr — PR главной страницы,
    • category_id — ID категории,
    • date_created — дата регистрации,
    • дата последнего изменения максимума ссылок для площадки,
    • status — статус:
      • NEW — новый,
      • IND — проиндексирован,
      • OK — работает,
      • IND_NOW — в процессе индексации,
      • FAIL — не прошёл модерацию,
      • IND_WAIT — ожидает индексацию,
      • REIND_NOW — в процессе переиндексации,
      • REIND_WAIT — ожидает переиндексацию.
    • comment_admin — комментарий модератора,
    • domain_level — уровень домена,
    • flag_auto — флаг авторежима,
    • mpp_1, mpp_2, mpp_3 — максимальное количество ссылок на каждом уровне,
    • flag_blocked_in_yandex — флаг забаненности в Yandex,
    • flag_hide_url — скрывать УРЛ,
    • links_delimiter — разделитель ссылок,
    • links_css_class — класс ссылок,
    • links_css_class_context — класс контекстных ссылок,
    • flag_use_unprintable_words_stop_list, flag_use_adult_words_stop_list, flag_use_ambiguous_words_stop_list — флаги использования стандартных списков стоп-слов,
    • flag_not_for_sale — флаг приостановки продажи ссылок,
    • amount_today — сумма за сегодня,
    • amount_yesterday — сумма за вчера,
    • amount_total — сумма всего,
    • in_yaca — наличие сайта в Yandex каталоге,
    • in_dmoz — наличие сайта в DMOZ,
    • nof_yandex — количество страниц в Yandex,
    • nof_google — количество страниц в Google,
    • days_to_recheck — количество дней до возможности запустить переиндексацию,
    • show_only_block — флаг блочного отображения ссылок,
    • nof_traf_pages — количество трафиковых страниц,
    • auto_set_prices — автоматически устанавливать новые цены на страницах:
      • 0 — не устанавливать,
      • 1 — средние по сайту,
      • 2 — заданные вручную,
      • 3 — средние по системе, умноженные на auto_set_prices_factor.
    • auto_set_prices_factor — множитель новых цен для страниц (от 0.1 до 3; используется, когда auto_set_prices = 3),
    • pr_change_auto_set_prices — при изменении PRа страниц автоматически устанавливать новые цены:
      • 0 — не устанавливать,
      • 1 — средние по сайту,
      • 2 — заданные вручную,
      • 3 — средние по системе, умноженные на pr_change_prices_factor.
    • pr_change_prices_factor — множитель новых цен для страниц при изменении PRa(от 0.1 до 3; используется, когда pr_change_auto_set_prices = 3)
    • pr_change_auto_set_prices_link — при изменении PRа страниц автоматически менять цены на текуще ссылки (0 - не менять, 1 - менять),
    • block_links_control — параметры блочного отображения ссылок
      • background_color — цвет фона,
      • border_color — цвет рамки,
      • header_color — цвет заголовка,
      • text_color — цвет текста,
      • url_color — цвет url-а,
      • sign_color — цвет подписи,
      • header_size — размер заголовка,
      • text_size — размер текста,
      • url_size — размер урла,
      • sign_size — размер подписи,
      • border_width — ширина рамки,
      • border_use_radius — закруглять урлы,
      • text_align — выравнивание текста внутри блока,
      • text_sign — текст подписи,
      • block_orientation — ориентация текста внутри блока (0 вертикальная, 1 - горизонтальная),
      • show_header — флаг показа заголовка,
      • show_url — флаг показа урла,
      • block_width_custom — ширина блока,
      • css_class_prefix — префикс названий классов css,
      • block_no_css — (0 - генерировать автоматически и внедрять в код страницы,1 - использовать свою таблицу стилей ),
      • block_width — ширина блока ссылок,
      • block_width_unit — тип измерения ширины (px или %).
  • (array) sape.site_update((int) site_id, (hash) site_params) — изменение настроек сайта в соответствии с переданными параметрами, возможные параметры:
    • auto; автоматический режим,
    • flag_hide_url; скрывать урл,
    • flag_use_unprintable_words_stop_list; использовать списки слов-стоп ненормативной лексики,
    • flag_use_adult_words_stop_list; использовать списки слов-стоп adult-тематики,
    • flag_use_ambiguous_words_stop_list; использовать списки сомнительных слов-стоп,
    • flag_reject_foreign_words; не принимать ссылки полностью на латинице,
    • auto_activate_pages; автоматически активировать новые страницы,
    • flag_not_for_sale; не принимать новые заявки на сайт,
    • flag_no_dispenser_check; на этом сайте ссылки размещаются «вручную»,
    • auto_set_prices; автоматически устанавливать новые цены (0 — не устанавливать,1 — средние по сайту, 2 — средние по системе умноженные на(auto_set_prices_factor), 3 — заданные вручную),
    • auto_set_prices_factor; значение для флага "средние по системе умноженные на",
    • pr_change_auto_set_prices_link; менять цены для текущих ссылок при изменении PR,
    • pr_change_auto_set_prices; автоматически устанавливать новые цены при изменении PR(0 — не устанавливать,1 — средние по сайту, 2 — средние по системе умноженные на(pr_change_prices_factor), 3 — заданные вручную),
    • pr_change_prices_factor; значение для флага "средние по системе умноженные на" при изменении PR,
    • nof_placements_autostop; количество ссылок в статусе OK после которого следует останавливать прием заявок,
    • price_context_factor_l1; установка множителя цены для контекстных ссылок с главной страницы,
    • price_context_factor_l2; установка множителя цены для контекстных ссылок для страниц второго уровня,
    • price_context_factor_l3; установка множителя цены для контекстных ссылок для страниц третьего уровня,
    • traf_factor; установка множителя цены для траффиковых страниц, цены обновляются сразу
    • show_only_block; режим отображения ссылок (0 - смешанный, 1 - только в формате блоков),
    • block_links_control — параметры блочного отображения ссылок
      • background_color — цвет фона,
      • border_color — цвет рамки,
      • header_color — цвет заголовка,
      • text_color — цвет текста,
      • url_color — цвет url-а,
      • sign_color — цвет подписи,
      • header_size — размер заголовка,
      • text_size — размер текста,
      • url_size — размер урла,
      • sign_size — размер подписи,
      • border_width — ширина рамки,
      • border_use_radius — закруглять урлы,
      • text_align — выравнивание текста внутри блока,
      • text_sign — текст подписи,
      • block_orientation — ориентация текста внутри блока (0 вертикальная, 1 - горизонтальная),
      • show_header — флаг показа заголовка,
      • show_url — флаг показа урла,
      • block_width_custom — ширина блока,
      • css_class_prefix — префикс названий классов css,
      • block_no_css — (0 - генерировать автоматически и внедрять в код страницы,1 - использовать свою таблицу стилей ),
      • block_width — ширина блока ссылок,
      • block_width_unit — тип измерения ширины (px или %).
  • (array) sape.get_site_regions((int) site_id) — список регионов сайта.
  • (array) sape.get_site_page((int) site_id, (int) page_id) — свойства страницы сайта:
    • статус и статус контекстный:
      • NEW — новая,
      • OK — активная,
      • DEL — удалена,
      • NO_CODE — код не найден.
    • УРЛ страницы,
    • PR,
    • уровень вложенности,
    • количество внешних ссылок,
    • цена,
    • количество ссылок.
  • (array) sape.get_site_pages((int) site_id [, (array) opts ]) — возвращает список страниц сайта
    opts может содержать следующие параметры —
    • (int) level,
    • (int) pr,
    • (int) only_ext_links,
    • (int) pn = 0,
    • (int) ps = 0.
    Структура ответа:
    • ID страницы,
    • статус и статус контекстный:
      • NEW — новая,
      • OK — активная,
      • DEL — удалена,
      • NO_CODE — код не найден.
    • УРЛ страницы,
    • PR,
    • уровень вложенности,
    • количество внешних ссылок,
    • цена,
    • количество ссылок,
    • Sape Rank.
  • (int) sape.site_pages_activate((int) site_id, [(int/array) page_ids], [(bool) flag_context = false]) — активация страниц сайта, возвращает количество активированных страниц.
  • (int) sape.site_pages_exclude((int) site_id, (int/array) page_ids, [(bool) flag_context = false]) — исключение страниц сайта, возвращает количество исключенных страниц.
  • (int) sape.site_pages_purge((int) site_id, (int/array) page_ids, [(bool) flag_context = false]) — удаление страниц сайта, возвращает количество удаленных страниц.
  • (array) sape.get_site_links((int) site_id [, (array) opts ]) — возвращает список ссылок сайта
    opts может содержать следующие параметры —
    • (string) status,
    • (timestamp) date_start,
    • (timestamp) date_stop,
    • (int) pn = 0,
    • (int) ps = 0,
    • (bool) clipped = 0 — возвращает только важные поля,
    • (int|array) pl_ids = 0 — возвращает, только определенные ссылки,
    • (bool) excess_external = 0 — возвращает только ссылки со страниц с превышением внешних.
    Структура ответа:
    • ID ссылки,
    • статус:
      • WAIT_WM — ожидает подтверждения вебмастера,
      • WAIT_SEO — ожидает подтверждения оптимизатора,
      • OK — размещена,
      • ERROR — не найдена,
      • SLEEP — заблокирована из-за нехватки денег у оптимизатора.
    • ID страницы,
    • УРЛ акцептора,
    • текст ссылки,
    • цена,
    • новая цена,
    • дата размещения ссылки,
    • дата блокировки ссылки (по статусам ERROR или SLEEP),
    • дата смены цены,
    • флаг контекстности,
    • ID сайта,
    • ID домена,
    • Sape Rank, если страница трафиковая. В противном случае, в этом поле будет -1.
  • (array) sape.get_sites_links_count([(string) status]) — количество ссылок по сайтам.
  • (array) sape.get_sites_pages_count([(string) status]) — количество страниц по сайтам.
  • (int) sape.get_site_pages_count((int) site_id [, (string) status]) — количество страниц по одному сайту.
  • (array) sape.get_sites_pages_context_count([(string) status]) — количество контекстных страниц по сайтам.
  • (int) sape.get_site_pages_context_count((int) site_id [, (string) status]) — количество контекстных страниц по одному сайту.
  • (array) sape.get_site_money_stats((int) site_id [, (int) year [, (int) month [, (int) day]]]) — статистика доходов по сайту.
  • (array) sape.get_projects([(bool|hash) show_deleted] [, (int) pn = 0 [, (int) ps = 10000]]) — список проектов пользователя.
    Возможна передача параметров в виде хеша:
    • (bool) show_deleted - показывать удаленные,
    • (bool) show_count - показывать количество урлов и ссылок в статусе ОК.
    Возвращает список, каждый элемент содержит:
    • ID проекта,
    • название,
    • автоматически снимать ссылки с сайтов, отсутствующих в ПС Яндекс,
    • не распространять ограничение на число ВС на избранные сайты,
    • автоматически снимать ссылки для главных страниц, количество ВС на которых превысило указанное значение,
    • автоматически снимать ссылки для страниц второго УВ, количество ВС на которых превысило указанное значение,
    • автоматически снимать ссылки для страниц третьего УВ, количество ВС на которых превысило указанное значение,
    • автоматически снимать ссылки, имеющие статус ERROR столько дней подряд,
    • потрачено за сегодня,
    • потрачено за вчера,
    • потрачено всего,
    • дата создания,
    • количество урлов проекта,
    • количество ссылок в статусе OK.
  • (array) sape.get_project((int) project_id) — параметры проекта пользователя:
    • ID проекта,
    • название,
    • автоматически снимать ссылки с сайтов, отсутствующих в ПС Яндекс,
    • не распространять ограничение на число ВС на избранные сайты,
    • автоматически снимать ссылки для главных страниц, количество ВС на которых превысило указанное значение,
    • автоматически снимать ссылки для страниц второго УВ, количество ВС на которых превысило указанное значение,
    • автоматически снимать ссылки для страниц третьего УВ, количество ВС на которых превысило указанное значение,
    • автоматически снимать ссылки, имеющие статус ERROR столько дней подряд,
    • потрачено за сегодня,
    • потрачено за вчера,
    • потрачено всего,
    • дата создания,
    • дата удаления (только для удаленных проектов),
    • количество урлов проекта,
    • количество ссылок в статусе OK.
  • (boolean) sape.project_update((int) project_id, (hash) project_params) — изменение настроек проекта в соответствии с переданными параметрами, возможные параметры:
    • name; название,
    • flag_cancel_links_yabl; автоматически снимать ссылки с сайтов, отсутствующих в ПС Яндекс,
    • flag_ext_links_max_no_wl; не распространять ограничение на число ВС на избранные сайты,
    • nof_ext_links_max_l1; автоматически снимать ссылки для главных страниц, количество ВС на которых превысило указанное значение,
    • nof_ext_links_max_l2; автоматически снимать ссылки для страниц второго УВ, количество ВС на которых превысило указанное значение,
    • nof_ext_links_max_l3; автоматически снимать ссылки для страниц третьего УВ, количество ВС на которых превысило указанное значение,
    • nof_days_to_keep_errors; автоматически снимать ссылки, имеющие статус ERROR столько дней подряд,
  • (hash) sape.get_url((int) url_id [, (boolean) show_deleted]) — информация о УРЛе (включая удалённые, если show_deleted == true), результат содержит:
    • ID УРЛа,
    • ID проекта,
    • УРЛ,
    • название,
    • режим модерации,
    • полуавтоматический режим,
    • дата создания,
    • сумма за сегодня,
    • сумма за вчера,
    • сумма всего,
    • общее количество ссылок,
    • период запуска авторежима,
    • ключевое слово,
    • позиция в yandex,
    • изменение позиции в yandex,
    • дата изменения позиции в yandex,
    • позиция в mail,
    • изменение позиции в mail,
    • дата изменения позиции в mail.
  • (array) sape.get_urls((int) project_id [, (boolean) show_deleted], (array) opts ]) — список УРЛов проекта (включая удалённые, если show_deleted == true), каждый элемент содержит:
    • ID УРЛа,
    • ID проекта,
    • УРЛ,
    • название,
    • режим модерации,
    • полуавтоматический режим,
    • дата создания,
    • сумма за сегодня,
    • сумма за вчера,
    • сумма всего,
    • общее количество ссылок,
    • период запуска авторежима,
    • ключевое слово,
    • позиция в yandex,
    • изменение позиции,
    • дата изменения позиции.
    $opts может содержать следующие параметры —
    • (boolean) tiny - выводить краткую информацю,
    • (int) pn = 0,
    • (int) ps = 0
  • (array) sape.get_url_links((int|array) url_id [, (string) status, (timestamp) date_start, (timestamp) date_stop, (int) pn = 0]) — список ссылок УРЛ(a/ов), каждый элемент содержит:
    • ID ссылки,
    • статус:
      • WAIT_WM — ожидает подтверждения вебмастера,
      • WAIT_SEO — ожидает подтверждения оптимизатора,
      • OK — размещена,
      • ERROR — не найдена,
      • SLEEP — заблокирована вручную или из-за нехватки денег у оптимизатора.
    • флаг, указывающий на SLEEP по балансу (из-за нехватки денег у оптимизатора)
    • ID сайта,
    • ID УРЛа,
    • УРЛ сайта,
    • CY сайта,
    • ID страницы,
    • УРЛ страницы,
    • PR страницы,
    • уровень вложенности страницы,
    • количество внешних ссылок на странице,
    • текст ссылки,
    • цена,
    • новая цена,
    • дата размещения ссылки,
    • дата блокировки ссылки (по статусам ERROR или SLEEP),
    • дата смены цены,
    • флаг контекстности,
    • флаг есть ли в DMOZ,
    • флаг есть ли в YACA,
    • ID категории,
    • Sape Rank, если ссылка трафиковая. В противном случае, в этом поле будет -1.
    • ID авто-фильтра, по которому пришла ссылка.
  • (array) sape.get_project_sites((int) project_id ) — список ID площадок, на которых куплены ссылки;
  • (array) sape.get_project_links((int|array) project_id [, (string) status, (timestamp) date_start, (timestamp) date_stop, (int) pn = 0]) — список ссылок проекта, каждый элемент содержит:
    • ID ссылки,
    • статус:
      • WAIT_WM — ожидает подтверждения вебмастера,
      • WAIT_SEO — ожидает подтверждения оптимизатора,
      • OK — размещена,
      • ERROR — не найдена,
      • SLEEP — заблокирована вручную или из-за нехватки денег у оптимизатора.
    • флаг, указывающий на SLEEP по балансу (из-за нехватки денег у оптимизатора)
    • ID сайта,
    • ID УРЛа,
    • УРЛ сайта,
    • CY сайта,
    • ID страницы,
    • УРЛ страницы,
    • PR страницы,
    • уровень вложенности страницы,
    • количество внешних ссылок на странице,
    • текст ссылки,
    • цена,
    • новая цена,
    • дата размещения ссылки,
    • дата блокировки ссылки (по статусам ERROR или SLEEP),
    • дата смены цены,
    • флаг контекстности,
    • Sape Rank, если ссылка трафиковая. В противном случае, в этом поле будет -1.
    • ID авто-фильтра, по которому пришла ссылка,
    • количество свободных мест на странице.
  • (array) sape.get_urls_links_count((int|array) project_id [, (string) status, (timestamp) date_start, (timestamp) date_stop]) — количество ссылок по урлам
  • (array) sape.get_url_anchors((int) url_id) — список анкоров УРЛа, каждый элемент содержит:
    • ID анкора,
    • сам анкор,
    • количество использованных раз.
  • (int) sape.get_url_anchors_count((int) url_id) — количество анкоров УРЛа
  • (array) sape.get_urls_anchors_count((hash) params) — список количества анкоров по всем УРЛам.Возможные параметры вызова:
    • (int|array) project_id - ID проекта/проектов,
    • (int|array) url_id - ID урла/урлов.
    Результат содержит:
    • ID урла,
    • количество анкоров.
  • (string|array) sape.get_placement_status((string) id [, (bool) check_sleep_balance = false]) — возвращает текущий статус ссылки по ID. Если указан флаг check_sleep_balance, то будет возвращён массив со следующими полями:
    • Статус ссылки,
    • флаг, указывающий на SLEEP по балансу (из-за нехватки денег у оптимизатора)
  • (array) sape.get_url_money_stats((int) url_id [, (int) year [, (int) month [, (int) day]]]) — статистика расходов по УРЛу.
  • (array) sape.get_project_money_stats((int) project_id [, (int) year [, (int) month [, (int) day]]]) — статистика расходов по проекту.
  • (array) sape.get_projects_money_stats((int) year [, (int) month [, (int) day]]) — статистика расходов по всем проектам.
  • (array) sape.get_balance_money_stats((int) year [, (int) month [, (int) day]]) — статистика изменений баланса.
  • (array) sape.get_categories() — массив категорий сайтов.
  • (array) sape.get_domain_zones() — массив доменных зон.
  • (array) sape.get_regions() — массив регионов.
  • (array) sape.get_yaca_categories() — массив категорий YACA.
  • (array) sape.get_whitelists() — массив списков избранного.
  • (array) sape.get_messages((hash) filter, [(int) pn = 0 [, ps = 100]]) — выбор сообщений по параметрам, указанным в ассоциированном массиве filter (pn - номер страницы, ps - кол-во сообщений на странице (ps может принимать следующие значения:10,50,100,250,500,1000)). Возможные фильтры:
    • dates — массив дат за которые необходимо получить сообщения, доступны только последние семь дней
    • query — текст фильтра(UTF-8)
    • types — массив типов сообщений
      • 1 - На собственной странице * размещена новая ссылка * на URL *
      • 2 - Новая заявка на размещение на странице * ссылки * на URL *
      • 3 - Размещение на странице * ссылки * на URL * утверждено хозяином площадки (АВТО) и оптимизатором (АВТО)
      • 4 - Размещение на странице * ссылки * на URL * утверждено хозяином площадки (АВТО) и ожидает подтверждения оптимизатора.
      • 5 - Размещение на странице * ссылки * на URL * отменено.
      • 6 - На собственной странице * обновился текст ссылки на URL * — новый текст *
      • 7 - Заявка на смену текста ссылки на URL * на странице * — новый текст *
      • 8 - Новая цена (*) для размещения ссылки * на сайт * на странице * принята.
      • 9 - Размещение на странице * ссылки * на URL * подтверждено оптимизатором.
      • 10 - Площадка * [ID:*] удалена вебмастером из системы вместе со всеми заявками и ссылками!
      • 11 - Проект * удалён
      • 12 - В проект * добавлен URL *
      • 13 - Удаление URL из проекта
      • 14 - От Вашего сайта * [ID:*] в течение последних * дней не было ни одного обращения к нашему серверу за новыми ссылками. Покупка новых ссылок на сайте приостановлена. Напишите в обратную связь, когда исправите проблему.
      • 15 - При очередной проверке размещения ссылок, на странице * не была найдена ваша ссылка * на сайт *. Это может быть связано с проблемами хостинга у площадки. Средства с вашего счета не будут списаны за эти сутки, при восстановлении работоспособности площадки размещение вашей ссылки возобновится.
      • 16 - Число внешних ссылок на всех страницах сайта * обновлено нашим роботом.
      • 17 - Cайт * не проиндексирован поисковой системой Яндекс.
      • 18 - Главная страница сайта * не отвечает! Примите необходимые меры и добавьте сайт в систему снова.
      • 19 - Ваш сайт * проиндексирован нашим роботом и отправлен на модерацию. Для начала работы следует разрешить найденные роботом страницы к продаже. Сайт заработает после проверки нашим модератором.
      • 20 - Cайт * удалён из системы.
      • 21 - Ваш сайт * проиндексирован нашим контекстным роботом. Для начала работы следует разрешить найденные роботом страницы с контекстным кодом к продаже.
      • 22 - Цена на размещение ссылки * [*] на странице * увеличена с * до * . У Вас есть * дней, чтобы принять новую цену или отказаться от этой ссылки.
      • 24 - Размещение на странице * ссылки * на URL * утверждено хозяином площадки и оптимизатором (АВТО).
      • 25 - Размещение на странице * ссылки * на URL * утверждено хозяином площадки и ожидает подтверждения оптимизатора.
      • 26 - Ваш УРЛ [ID:*] из проекта * был принудительно переведён в ручной режим работы из полу-автоматического в связи с тем, что в течение 10 дней Вами не было одобрено/отклонено ни одной подобранной автоматом заявки.
      • 27 - Режим модерации УРЛа * был изменён на ручной/автоматический
      • 28 - Проект * усыплён
      • 29 - Размещение на странице * ссылки * на URL * приостановлено из-за нулевого баланса оптимизатора (ссылка переведена в статус SLEEP).
      • 31 - Ваш сайт * [ID:*] активирован вами после отсутствия обращения к нашему серверу за новыми ссылками.
      • 32 - Размещение на странице * ссылки * на URL * восстановлено (ссылка переведена из статуса SLEEP в статус ОК).
      • 33 - Заявка на смену текста ссылки на URL * на странице * — новый текст * — утверждено хозяином площадки (АВТО).
      • 34 - Настройка `Проставлять ссылкам атрибут rel="nofollow"` для URL * включена
      • 35 - Настройка `Проставлять ссылкам атрибут rel="nofollow"` для URL * сброшена
      • 36 - Частота работы авторежима на УРЛе * была изменена на * дня(ей).
      • 37 - На Вашем сайте * слишком большой процент ссылок в статусе ERROR. Покупка новых ссылок на сайте приостановлена. Напишите в обратную связь, когда исправите проблему.
      • 38 - При очередной проверке размещения ссылок, на странице * не была найдена ваша ссылка * на сайт *. Это может быть связано с проблемами хостинга у площадки. Средства с вашего счета не будут списаны за эти сутки, при восстановлении работоспособности площадки размещение вашей ссылки возобновится.
      • 39 - Заявка на странице * ссылки * на URL * отменена.
    Если что-то нашлось, то возвращается массив:
    • row_count — кол-во сообщений
    • page_count — кол-во страниц
    • messages — массив сообщений, каждый элемент содержит:
      • date — дата
      • body — текст сообщения(UTF-8)
      • type — тип
  • (int) sape.placements_accept_wm((array) ids) — одобрение ссылок вебмастером, возвращает количество успешно одобренных. Необходимо одобрять ссылки в статусе WAIT_WM. Массив не больше 100 элементов.
  • (array) sape.get_placements_new_prices((int) project_id[, (int) days]) — получение новых цен ссылок проекта (если project_id == 0 - всех проектов), изменившихся за определенное кол-во дней (по умолчанию 30). Возвращается массив, каждый элемент которого содержит:
    • id — ID ссылки
    • date — дата установки старой цены
    • price — старая цена
    • date_price_changed — дата установки новой цены
    • price_new — новая цена
  • (array) sape.get_projects_folders() — Возвращается массив, каждый элемент которого содержит:
    • ID проекта
    • ID раздела
    • название раздела
  • (array) sape.get_sites_folders() — Возвращается массив, каждый элемент которого содержит:
    • ID сайта
    • ID раздела
    • название раздела
  • (bool) sape.project_move_to_folder((int) project_id, (int) folder_id) — перенос проекта в другой раздел.
  • (bool) sape.site_move_to_folder((int) site_id, (int) folder_id) — перенос сайта в другой раздел.
  • (array) sape.get_placements_text_updates([(int) site_id) — получение заявок на смену текста. Если задан site_id, то только для сайта, иначе для всех сайтов пользователя. Возвращается массив, каждый элемент которого содержит:
    • id — ID ссылки
    • date_created — дата создания ссылки
    • txt — старый текст
    • request_date — дата создания заявки на смену текста
    • request_txt — новый текст
    • action_reject — флаг, указывающий на то, что будет, если отклонить заявку. 1 - старая ссылка сохраняется ; 2 - старая ссылка удаляется
  • (bool) sape.placement_delete((string) id) — удаление ссылки по ID.
  • (array) sape.placements_delete((array) ids) — удаление ссылок по массиву ID, возвращает массив ID успешно удалённых. Массив не больше 100 элементов.
  • (array) sape.placements_text_updates_accept((array) pl_ids) — одобрение заявок на смену текста. Возвращается массив с Id новых ссылок в том же порядке как и на входе.
  • (bool) sape.placements_text_updates_reject((array) pl_ids) — отклонение заявок на смену текста.

Описание дополнительных функций

Чтобы воспользоваться дополнительными функциями:

  • сделайте запрос в Службу поддержки, чтобы вам открыли эту возможность
  • измените адрес следующим образом: http://api.sape.ru/xmlrpc/?v=extended
  • (array) sape.search((int) url_id, (hash) filter, [(int) pn = 0 [, ps = 100]]) — поиск сайтов и страниц для УРЛа url_id по параметрам, указанным в ассоциированном массиве filter. Возможные фильтры:
    • site_id — ID сайта, можно через запятую,
    • cy_from — минимальное знаение тИЦ,
    • cy_2 — максимальное значение тИЦ,
    • domain_level — уровень домена,
    • domain_zones — массив с ID доменных зон,
    • categories — массив с ID категорий,
    • regions — массив с ID регионов,
    • yaca_categories — массив с ID категорий YACA,
    • whitelists — массив с ID списков избранного,
    • flag_blocked_in_yandex — наличие в Yandex: 0 - есть, 1 - нет, 2 - не важно (по умолчанию 0(Есть в Яндексе))
    • flag_blocked_in_google — наличие в Google: 0 - есть, 1 - нет, 2 - не важно (по умолчанию 2(Не важно))
    • in_yaca — сайты из YACA: нет параметра - все, 0 - только не в YACA, 1 - только в YACA,
    • in_dmoz — сайты из DMOZ: нет параметра - все, 0 - только не в DMOZ, 1 - только в DMOZ,
    • only_open_url — только сайты с открытыми УРЛами,
    • days_old_whois — количество дней, которые прошли с момента регистрации сайта,
    • date_added — количество дней, которые прошли с момента регистрации сайта в системе,
    • nogood — область поиска: 0 - все сайты, 1 - основная база, 2 - сайты сомнительного содержания,
    • double — отображать площадки с размещенными ссылками (0|1),
    • no_double_in_project — не отображать сайты, уже купленные в рамках других URL текущего проекта (0|1),
    • no_double_in_folder — не отображать сайты, уже купленные в рамках других URL текущего раздела (0|1),
    • price_from — минимальная цена страницы,
    • price_2 — максимальная цена страницы,
    • pr_from — минимальное значение PR,
    • pr_2 — максимальное значение PR,
    • site_pr_1 — минимальное значение PR главной,
    • site_pr_2 — максимальное значение PR главной,
    • tr_1 — минимальное значение SapeRank,
    • tr_2 — максимальное значение SapeRank,
    • mj_cf_1 — минимальное значение Majestic Citation Flow,
    • mj_cf_2 — максимальное значение Majestic Citation Flow,
    • mj_tf_1 — минимальное значение Majestic Trust Flow,
    • mj_tf_2 — максимальное значение Majestic Trust Flow,
    • level_from — минимальный уровень вложенности страницы,
    • level_2 — максимальный уровень вложенности страницы,
    • ext_links — максимальное число внешних ссылок,
    • ext_links_forecast — прогнозируемое число внешних ссылок,
    • words — ключевые слова,
    • words_type — где искать ключевые слова: 0 - в тексте страниц (по-умолчанию), 1 - в title страниц,
    • pages_per_site — количество страниц с сайта: "preferred" - только оптимальные (по умолчанию), "one" - одна, "all" - все страницы. Флаг "all" доступен если поиск осуществляется по конкретному сайту (т.е. задан один site_id),
    • links_display_mode — форма вывода ссылок: если не указано - не важно, 0 - стандартный, 1 - Блочный, 2 - Смешанный+Блочный
    • order — сортировка:
      • 1 - ID сайта ↓,
      • 11 - ID сайта ↑,
      • 2 - Домен ↓,
      • 12 - Домен ↑,
      • 3 - ТиЦ ↓,
      • 13 - ТиЦ ↑,
      • 4 - Категория ↓,
      • 14 - Категория ↑,
      • 5 - ID страницы ↓,
      • 15 - ID страницы ↑,
      • 6 - PR ↓,
      • 16 - PR ↑,
      • 7 - УВ ↓,
      • 17 - УВ ↑,
      • 8 - ВС ↓,
      • 18 - ВС ↑,
      • 9 - Цена ↓,
      • 19 - Цена ↑
    • show_title — Показывать тайтлы для страницы
    Если что-то нашлось, то возвращается массив, каждый элемент которого содержит:
    • id — ID сайта,
    • in_dmoz — есть ли в DMOZ,
    • in_yaca — есть ли в YACA,
    • category_id — ID категории,
    • region_id — ID регионов,
    • yaca_category_ids — ID категорий YACA,
    • cy — тИЦ,
    • domain_level — уровень домана,
    • url — УРЛ сайта,
    • pr — PR,
    • flag_blocked_in_yandex — наличие в Яндекс,
    • flag_blocked_in_google — наличие в Google,
    • nof_pages — количество страниц,
    • nof_pages_in_yandex — количество страниц в индексе Яндекс,
    • nof_pages_in_google — количество страниц в индексе Google,
    • pages — массив страниц сайта, каждый элемент содержит:
      • id — ID,
      • uri — URI,
      • pr — PR,
      • level — уровень вложенности,
      • ext_links — количество внешних ссылок,
      • price — цена,
      • free_places — количество свободных мест.
  • (string) sape.placement_create((int) page_id, (int) url_id, (string) anchor[, (hash) params)]) — размещение новой ссылки. В случае успеха возвращается ID ссылки. Если anchor число, то выбирается текст из БД текстов по ID==anchor. Если anchor==0, то берётся следующий неиспользованный текст. Возможные параметры:
    • max_price — максимальная цена за ссылку, если цена ссылки, больше максимальной, то не будем покупать,
    • force_seo_wait — установка статуса если это возможно: 1 - ожидает подтверждения оптимизатора, 2 - размещено.
  • (array) sape.placements_create((hash) placements) — размещение новых ссылок. В случае успеха возвращается массив с ID ссылок или описаниями ошибок. Массив placements (не больше 100 элементов) надо составлять следующим образом:
    • page_id — число,
    • url_id — число,
    • (string) anchor — если число, то выбирается текст из БД текстов по ID==anchor. Если anchor==0, то берётся следующий неиспользованный текст. Если передаётся текст, то он и станет анкором.
    • params — массив, возможные параметры:
      • max_price — максимальная цена за ссылку, если цена ссылки, больше максимальной, то не будем покупать,
      • force_seo_wait — установка статуса если это возможно: 1 - ожидает подтверждения оптимизатора, 2 - размещено.
  • (int) sape.placement_update_url((string) id, (int) url_id) — изменение URL ссылки. Перенос ссылок возможен только между URL-ами одного домена.
  • (text|bool) sape.placement_update_text((string) id, (string) anchor [, (int) action_reject = 1]) — обновление текста ссылки. Если anchor число, то выбирается текст из БД текстов по ID==anchor. Если anchor==0, то берётся следующий неиспользованный текст. В случае успеха возвращает ID ссылки с новым текстом или true если добавлена заявка на смену текста.
    action_reject — действие при отказе вебмастера сменить текст: 1 - оставить ссылку, 2 - снять ссылку.
  • (string) sape.placements_update_text_delayed((hash) pl_anchor [, (int) action_reject = 1]) — фоновое обновление текстов ссылок.  Возвращает указатель на задание (handler);
    • pl_anchor — ключами данного массива должны быть идентификаторы ссылок в виде строки, а значениями тексты или идентификаторы анкоров:
      array (
      (string) pl_id => (string) anchor,
      ...
      );
    • action_reject — действие при отказе вебмастера сменить текст: 1 - оставить ссылку, 2 - снять ссылку.
  • (bool) sape.placement_accept_seo((string) id) — одобрение ссылки оптимизатором. Необходимо одобрять ссылки в статусе WAIT_SEO.
  • (array) sape.placements_accept_seo((array) ids) — одобрение ссылок оптимизатором. Необходимо одобрять ссылки в статусе WAIT_SEO. Массив не больше 100 элементов. Возвращается массив, каждый элемент которого содержит:
    • id — ID ссылки
    • status — статус: 0 - ALREADY_IS, 1 - OK, -1 - FAILED
  • (array) sape.placement_sleep_url((int) url_id) — заморозка всех ссылок УРЛа. Возвращается массив со статистикой:
    • slept — количество успешно замороженных ссылок,
    • not_slept — количество ссылок, во время заморозки которых произошла ошибка,
    • removed — количество удалённых заявок.
  • (bool) sape.placement_sleep_project((int) project_id) — заморозка всех ссылок всех УРЛов проекта.
  • (int) sape.placement_unsleep_url((int) url_id) — разморозка всех ссылок УРЛа. В случае успеха возвращает количество успешно размороженных ссылок.
  • (int) sape.placement_sleep((array|string) placement_ids) — заморозка ссылки или группы ссылок. В случае успеха возвращает количество успешно змороженных ссылок
  • (int) sape.placement_unsleep((array|string) placement_ids) — разморозка ссылки или группы ссылок. В случае успеха возвращает количество успешно размороженных ссылок
  • (int) sape.placements_delete_url((int) url_id [, (string) status]) — отказ от всех ссылок УРЛа (если не указан статус, будут удалены все). В случае успеха возвращает количество успешно удалённых заявок.
  • (int) sape.placements_wait_delete_url((int) url_id) — отказ от всех WAIT ссылок УРЛа(WAIT_SEO и WAIT_WM). В случае успеха возвращает количество успешно удалённых заявок.
  • (bool) sape.placements_new_price_accept((array) pl_ids) — одобрение новых цен ссылок в конце срока.
  • (bool) sape.placements_new_price_reject((array) pl_ids) — отклонение новых цен ссылок в конце срока.
  • (int) sape.project_add((string) name) — создание нового проекта, в случае успеха возвращает его ID.
  • (bool) sape.project_delete((int) project_id) — удаление проекта.
  • (int) sape.url_add((int) project_id, (string) url [, (string) name [, (string) keyword]]) — добавление в проект нового УРЛа, в случае успеха возвращает его ID.
  • (bool) sape.url_update((int) url_id, (hash) params) — изменение настроек УРЛа в соответствии с переданными параметрами, возможные параметры:
    • project_id; ID проекта,
    • url; урл,
    • name; название,
    • keyword; ключевое слово,
    • auto_activity_period; период запуска авторежима,
    • flag_hide_links_from_se; проставлять ссылкаматрибут rel="nofollow" (можно менять только раз в сутки).
  • (bool) sape.url_delete((int) url_id) — удаление УРЛа.
  • (string) sape.url_anchor_add((int) url_id, (string) anchor [, (hash) params)]) — добавление для УРЛа нового текста, в случае успеха возвращает его ID, который можно в дальнейшем использовать при создании новых ссылок и смене текстов. Возможные параметры:
    • limit— максимальное количество использования текста в ссылках
  • (array) sape.url_anchors_add((int) url_id, (array) anchor [, (hash) params)]) — добавление для УРЛа новых текстов, возвращает массив ID успешно добавленных текстов или массив с ID и Ошибками (см. параметр return_errors), которые можно в дальнейшем использовать при создании новых ссылок и смене текстов. Возможные параметры:
    • limit— максимальное количество использования текста в ссылках
    • return_errors— Возвращать ошибки, ответ будет в виде array(anchors_id => array(id,...), errors=>array(array(error_code,text_num),...), где text_num - порядковый номер недобавленного текста (нумерация от 1)
    • check_exist— Возвращать ошибку, если переданный текст уже существует на УРЛе. Если параметр не указан, то в случае наличия дубля анкора будет возвращаться ID уже существующего анкора
  • (bool) sape.url_anchor_delete((int) url_id, (string) anchor) — удаление текста из базы текстов УРЛа (можно указывать id или непосредственно строку), в случае успеха возвращает true, если такого текста нет — ошибка.
  • (int) sape.url_anchors_delete((int) url_id ,[ (array) anchor_ids]) — удаление всех текстов (или заданных текстов, если задан anchor_ids) из базы текстов УРЛа, в случае успеха возвращает количество удалённых текстов.
    • anchor_ids — массив id анкоров в виде строк
  • (bool) sape.url_set_autoseo((int) url_id, (boolean) flag_auto, (boolean) flag_require_confirm) — изменение режима модерации УРЛа: flag_auto == false — ручной, (flag_auto == true && flag_require_confirm == false) — автоматический, (flag_auto == true && flag_require_confirm == true) — полуавтоматический.
  • (int) sape.project_bl_add((int) project_id, (array) domains[, (bool) auto_remove_placements = true])— добавление доменов в черный список проекта. Возвращает количество успешно добавленных.
  • (int) sape.project_bl_del((int) project_id, (array) domains)— удаление доменов из черного списка проекта. Возвращает количество успешно удаленных.
  • (array) sape.get_project_bl_domains((int) project_id, [(int) pn = 0 [, (int) ps = 100]])— получение доменов черного списка проекта. Возвращается массив, каждый элемент которого содержит:
    • id — ID домена;
    • domain — домен.
  • (int) sape.projects_gbl_add((array) domains[, (bool) auto_remove_placements = true])— добавление доменов в глобальный черный список. Возвращает количество успешно добавленных.
  • (int) sape.projects_gbl_del((array) domains)— удаление доменов из глобального черного списка. Возвращает количество успешно удаленных.
  • (array) sape.get_projects_gbl_domains([(int) pn = 0 [, (int) ps = 100]])— получение доменов ГБЛ. Возвращается массив, каждый элемент которого содержит:
    • id — ID домена;
    • domain — домен.
  • (int) sape.wl_add((array) domains, (int/array) wl_ids)— добавление доменов в раздел/разделы избранного. Возвращает количество успешно добавленных.
  • (bool) sape.wl_del((array) domain_ids, (int/array) wl_ids)— удаление доменов из раздела/разделов избранного.
  • (array) sape.get_wl_domains((int) wl_id [, (int) pn = 0 [, (int) ps = 100]])— получение доменов раздела избранного. Возвращается массив, каждый элемент которого содержит:
    • id — ID домена;
    • domain — домен.
  • (int) sape.whitelist_create((string) domain)— добавление раздела избранного, в случае успеха возвращает его ID.
  • (bool) sape.whitelist_delete((int) wl_id)— удаление раздела избранного.
  • (array) sape.get_urls_money_stats((array) url_ids, (int) year[, (int) month = null[, (int) day = null]])— получение статистики расходов по УРЛам за период времени.
    Возвращает массив статистики расходов, который имеет следующую структуру:
    • total — суммарный расход;
    • items — массив данных статистики:
      • id — идентификатор УРЛа;
      • date_logged — дата;
      • sum — расход.
    Ограничения:
    • выборка статистики за период не более года (т.е. параметр year нужно обязательно указывать);
    • не более 500 идентификаторов УРЛов.
  • (int) sape.filter_create((string) filter_name, (hash) filter) — добавление фильтра с параметрами указанными в ассоциированном массиве filter. Возможные фильтры:
    • ext_links — максимальное число внешних ссылок.
    • ext_links_forecast — максимальное прогнозируемое число внешних ссылок.
    • cy_from — минимальное значение тИЦ,
    • cy_2 — максимальное значение тИЦ,
    • pr_from — минимальное знаение PR,
    • pr_2 — максимальное значение PR,
    • price_from — минимальная цена страницы,
    • price_2 — максимальная цена страницы,
    • level_from — минимальный уровень вложенности страницы,
    • level_2 — максимальный уровень вложенности страницы,
    • in_yaca — сайты из YACA: нет параметра - все, 0 - только не в YACA, 1 - только в YACA,
    • in_dmoz — сайты из DMOZ: нет параметра - все, 0 - только не в DMOZ, 1 - только в DMOZ,
    • domain_level — уровень домена,
    • categories — массив с ID категорий,
    • no_double_in_project — Не отображать сайты, уже купленные в рамках других УРЛ текущего проекта,
    • flag_blocked_in_yandex — показывать сайты, которых нет в Яндексе (0-нет|1-да|2-не важно),
    • flag_blocked_in_google — показывать сайты, которых нет в Google (0-нет|1-да|2-не важно),
    • words — ключевые слова, минимум 4 символа,
    • whitelists — массив с ID списков избранного,
    • nogood — область поиска: 0 - все сайты, 1 - основная база, 2 - сайты сомнительного содержания,
    • date_added — количество дней, которые прошли с момента регистрации сайта в системе,
    • domain_zones — массив доменных зон, например ('ru', 'com', 'org'),
    • days_old_whois — минимальный возраст домена в днях,
    • links_display_mode — формат вывода ссылок(-1-любой|0-стандартный|1-блочный|2-смешанный).
    Если добавилось успешно, то возвращает ID фильтра.
  • (bool) sape.filter_update((int) filter_id, (hash) new_filter) — изменение параметров фильтра: см. выше, + filter_name;
  • (bool) sape.filter_delete((int) filter_id [, (boolean) force_delete = false]) — удаление фильтра, если параметр force_delete == true, то удаляет все автофильтры которые привязаный к фильтру, в противном случае выполняет проверку есть ли автофильтры и если есть, то не будет удалять фильтр.
  • (int) sape.filter_auto_create((int) filter_id, (int) url_id, (int) quant, (int) price, (int) daily_quota) — Создание авто-фильтра для урла, если добавилось успешно, то возвращает ID авто-фильтра.
  • (bool) sape.filter_auto_update((int) filter_auto_id, (int) quant, (int) price, (int) daily_quota) — Изменение авто-фильтра для УРЛа.
  • (bool) sape.filter_auto_delete((int) filter_auto_id) — удаление авто-фильтра.
  • (array) sape.get_filters([(boolean) show_params = false]) — получение списка фильтров, если указан параметр show_params, то возвращает параметры фильтра в виде хэша.
  • (array) sape.get_filters_auto((int)/(array) url_id, [(boolean) show_budget = false]) — получение списка автофильтров для урла или списка урлов. Возвращается массив, каждый элемент которого содержит:
    • filter_auto_id — ID автофильтра
    • filter_id — ID фильтра
    • url_id — ID урла
    • quant — общая квота по ссылкам
    • price — бюджет автофильтра
    • daily_quota — дневная квота по ссылкам
    если show_budget = true, добавляются следующие поля:
    • current_quant — количество купленных ссылок
    • current_price — стоимость купленных ссылок
  • (int) sape.site_bl_add((array) $domains, [(int) site_id = 0]) — добавление списка доменов в BL или GBL (если site_id == 0). $domains - массив доменов, не более 100 элементов. Возвращает кол-во добавленных доменов.
  • (int) sape.site_bl_del((array) $domains, [(int) site_id = 0]) — удаление списка доменов из BL или GBL (если site_id == 0). $domains - массив доменов, не более 100 элементов. Возвращает кол-во удаленных доменов.
  • (bool) sape.site_set_max_per_page((int) site_id, (hash) params) — установка максимального количества ссылок. Возвращает false если количество для всех уровней не изменилось и true в противоположном случае. Увеличивать максимальное количество ссылок можно не чаще чем 1 раз в 2 недели. Возможные параметры:
    • mpp_1; максимальное количество ссылок для главной,
    • mpp_2; максимальное количество ссылок для страниц второго уровня,
    • mpp_3; максимальное количество ссылок для страниц третьего уровня
  • (bool) sape.page_update_price((int) site_id, (int) page_id, (float) price, [(bool)force = false]) — изменение цены страницы. Если force = true - обновятся цены на проданные ссылки.
  • (bool) sape.pages_update_price((int) site_id, (int) level, (int) pr, (float) price, [(bool)force = false]) — изменение цены страницы. Если force = true - обновятся цены на проданные ссылки. pr - может принимать значение 'all' если необходимо установить одну цену для определенного уровня вложенности;
  • (string) sape.placements_delete_delayed((array) pl_ids) — фоновое удаление ссылок.  Возвращает указатель на задание (handler);
  • (struct) sape.get_task_status((string) handler) — получения статуса задания по указателю. Возвращает массив, содержащий следующие поля:
    • status - статус выполнения:
      • 0 - ожидает выполнения
      • 1 - выполняется
      • 2 - выполнено
    • result - результат
    • sofar - количество выполненных операций задания
    • totalwork - общее количество операций задания
    поля result, sofar, totalwork - могут быть пустыми (зависит от выполняемого задания и статуса).
  • (int) sape.site_add((string) url, (int) category_id [, (string) url_code]) — добавление площадки в систему, в случае успеха возвращает ее ID.
  • (int) sape.site_delete((int) site_id) — удаление площадки из системы.
  • (hash) sape.get_stopwords() — получение списков стоп-слов пользователя. Возвращает массив хешей, содержащий следующие поля:
    • id - идентификатор спика,
    • name - имя списка,
    • words - список стоп-слов.
  • (array) sape.get_stopwords_site((int) site_id) — получение массива идентификаторов списков стоп-слов сайта.
  • (int) sape.stopwords_list_add((string) name, (string) words) — добавление списка стоп-слов.  Возвращает идентификатор созданного списка.
  • (void) sape.stopwords_list_update((id) list_id, (string) name, (string) words) — изменение списка.
  • (bool) sape.stopwords_list_delete((id) list_id) — удаление списка.
  • (void) sape.stopwords_words_add((id) list_id, (string) words) — добавление стоп-слов к списку.
  • (void) sape.stopwords_words_delete((id) list_id, (string) words) — удаление стоп-слов из списка.
  • (int) sape.stopwords_site_add((array) list_ids, (int) site_id) — привязка списков стоп-слов к сайту.  Возвращает количество привязанных списков.
  • (int) sape.stopwords_site_delete((array) list_ids, (int) site_id) — удаление связей списков стоп-слов и сайта.  Возвращает количество удаленных связей.

Коды и сообщения ошибок


КодСообщениеПеревод
100SAPE.RU: Not enough params :o(Не достаточно параметров
101SAPE.RU: Internal error :o(Внутренняя ошибка
102SAPE.RU: Bad or unknown ID :o(Неверный ID
110SAPE.RU: User registration failed :o(Пользователь не зарегистрирован
111SAPE.RU: Bad login :o(Неверный логин или пароль
112SAPE.RU: Login already in use :o(Данный логин уже есть в системе
113SAPE.RU: Email already in use :o(Данный e-mail уже есть в системе
114SAPE.RU: Password too short :o(Пароль слишком короткий
115SAPE.RU: Bad email :o(Невалидный e-mail
116SAPE.RU: Bad username :o(Некорректное имя пользователя
117SAPE.RU: Bad refid :o(Неверный ID реферала
118SAPE.RU: Bad user id :o(Неверный ID пользователя
119SAPE.RU: User not auth :o(Пользователь не авторизован
120SAPE.RU: Bad external system ID :o(Неправильный ID внешней системы
121SAPE.RU: Method is restricted for current user :o(Метод не разрешается вызывать для этого пользователя
122SAPE.RU: User does not exist :o(Пользователь не существует
123SAPE.RU: User does not have a phone :o(У пользователя нету телефона
140SAPE.RU: Billing in progress :o(Идёт биллинг
141SAPE.RU: Afterbilling aggregations building in progress :o(Идёт послебиллинговое построение аггрегаций
150SAPE.RU: Bad subscribe type :o(Неверный тип подписки
151SAPE.RU: Bad template id :o(Неверный id шаблона
210SAPE.RU: Anchor add failed :o(Анкор не добавлен
211SAPE.RU: Anchor delete failed :o(Анкор не удален
310SAPE.RU: Project create failed :o(Проект не создан
311SAPE.RU: Project bad name :o(Некорректное название прокта
320SAPE.RU: URL Add failed :o(URL не добавлен
321SAPE.RU: URL is banned :o(URL забанен
322SAPE.RU: Bad URL length :o(Неверная длина URLа
323SAPE.RU: URL is malformed :o(Неправильно сформированный URL
324SAPE.RU: Bad URL domain :o(Неверный домен URLа
325SAPE.RU: Url contains quote :o(URL содержит кавычки
330SAPE.RU: Site add failed :o(Сайт не добавлен
331SAPE.RU: Bad url :o(Неверный URL
332SAPE.RU: Site already exists :o(Сайт уже есть в системе
333SAPE.RU: No code on front page :o(Отсутствует код системы на главной странице
334SAPE.RU: No code on page :o(Отсутствует код системы на странице
335SAPE.RU: No connection to site :o(Ошибка связи с сервером
336SAPE.RU: Site cannot be reindexed now :o(В данный момент переиндексация сайта запрещена
337SAPE.RU: Site is already bought out :o(Сайт уже выкуплен
338SAPE.RU: Site reindex is already started :o(Ошибка, задание в очереди или уже выполняется.
410SAPE.RU: Placement create failed :o(Ссылка не создана
420SAPE.RU: Placement delete failed :o(Ссылка не удалена
430SAPE.RU: Placement update text failed :o(Текст ссылки не изменен
432SAPE.RU: Placement update price failed :o(Цена ссылки не изменена
435SAPE.RU: Placement update url failed :o(URL ссылки не изменен
440SAPE.RU: Placement accept SEO failed :o(Ссылка не подтверждена оптимизатором
450SAPE.RU: Placement unsleep failed :o(Ссылка не восстановлена
460SAPE.RU: Placement accept WM failed :o(Ссылка не подтверждена вебмастером
465SAPE.RU: Placement new price accept failed :o(Ошибка подтверждения новых цен
466SAPE.RU: Placement new price reject failed :o(Ошибка отклонения новых цен
470SAPE.RU: Autofilter create failed, no texts on urlАвтофильтр не создан, для URLа не создано ни одного текста
471SAPE.RU: Autofilter create failed, already existАвтофильтр не создан, уже существует
500SAPE.RU: Bad Project IDНеверный ID проекта
501SAPE.RU: Bad Site IDНеверный ID сайта
502SAPE.RU: Bad URL IDНеверный ID URLа
503SAPE.RU: Bad Placement IDНеверный ID ссылки
504SAPE.RU: Bad Placement TextНеверный текст ссылки
505SAPE.RU: Bad date in paramsНеверный формат даты в параметрах
506SAPE.RU: Bad Page IDНеверный ID страницы
507SAPE.RU: Bad Project ID - No URLsНеверный ID проекта - отсутствуют URLы
508SAPE.RU: Bad category idНеверный ID категории
509SAPE.RU: Bad filter idНеверный ID фильтра
510SAPE.RU: Bad whitelist idНеверный ID раздела в избранном
511SAPE.RU: Bad keywordНеверное ключевое слово
512SAPE.RU: Bad stop-words list IDНеверное ID списка стоп-слов
513SAPE.RU: Bad Project blacklist IDНе задан black-лист проекта
514SAPE.RU: Bad date intervalНеверный интервал дат
515SAPE.RU: Bad domain idНеверный ID домена
521SAPE.RU: Bad placement anchor IDНеверный ID анкора
522SAPE.RU: Empty placement anchorПустой анкор
523SAPE.RU: Malformed placement anchorНекорректный анкор
524SAPE.RU: Spammed placement anchorЗаспамленный анкор
525SAPE.RU: Anchor too longАнкор слишком длинный
526SAPE.RU: Anchor existАнкор существует
650SAPE.RU: Empty login :o(Пустой логин
651SAPE.RU: User is not activated :o(Пользователь не активирован
652SAPE.RU: Quantity of attempts of authentication for current IP is exceeded :o(Количество попыток авторизации для текущего IP исчерпано
653SAPE.RU: Login does not exist :o(Пользователь не существует
654SAPE.RU: Invalid authorization cookie :o(Неверная авторизационная cookie
655SAPE.RU: User is banned :o(Пользователь забанен
656SAPE.RU: User is blocked - need to change password :o(Пользователь заблокирован - должен сменить пароль
657SAPE.RU: Invalid authorization ticket :o(Неверный авторизационный тикет
660SAPE.RU: Access restricted for current IP :o(Доступ с текущего IP запрещен
661SAPE.RU: No partner contract :o(Нет договора партнерской программы
662SAPE.RU: No WM contract :o(Нет договора вебмастера
663SAPE.RU: No SEO contract :o(Нет договора оптимизатора
664SAPE.RU: Extended mode denied :o(Доступ к дополнительным функциям закрыт
665SAPE.RU: Not wizard accountЭто не визард аккаунт
666SAPE.RU: Invalid login or password :o(Неверный логин или пароль
667SAPE.RU: Please, loginПожалуйста авторизуйтесь в системе
668SAPE.RU: Quantity of attempts of authentication is exceededКоличество попыток авторизации исчерпано
669SAPE.RU: TEMPORARY UNAVAILABLEВременно не доступно
670SAPE.RU: Empty array!Пустой массив
671SAPE.RU: Input array empty!Входной массив данных пустой
672SAPE.RU: Return array empty!Выходной массив данных пустой
673SAPE.RU: Search result empty!Поиск вернул пустой результат
680SAPE.RU: Request processing error!Ошибка во время обработки запроса)
681SAPE.RU: Request already exist!Запрос уже существует
711SAPE.RU: Bill amount too small :o(Сумма счета слишком мала
800SAPE.RU: Bad handle :o(Неверный указатель
801SAPE.RU: Get task status failed :o(Ошибка получения статуса по переданному указателю
802SAPE.RU: Cannot get factor status :o(Невозможно получить статус фактора
900SAPE.RU: OAuth error :o(Ошибка OAuth
1000SAPE.RU: Elama error :o(Ошибка Elama
1100SAPE.RU: RT error :o(Ошибка RT
1200SAPE.RU: RTB error :o(Ошибка RTB
1300SAPE.RU: Letero error :o(Ошибка Letero
1400SAPE.RU: Wizard error :o(Ошибка Wizard
1500SAPE.RU: Archiving in PR failed :o(Архивирвоание проекта в PR закончилось неудачей
2101SAPE.RU: Anchor add_failed, bad name :o(Анкор не добавлен, некорректное название
2201SAPE.RU: Teaser upload failed, maximum allowed size for file 1.95MB :o(Файл с картинкой должен быть меньше 1.95MB
2202SAPE.RU: Teaser upload failed, file must be jpg, gif or png :o(Файл с картинкой должен быть в формате jpg, gif или png
2203SAPE.RU: Teaser upload failed, file broken:o(Файл с картинкой не читается
4101SAPE.RU: Placement create failed, undefined pageСсылка не создана, страница не определена
4102SAPE.RU: Placement create failed, big priceСсылка не создана, слишком высокая цена
4103SAPE.RU: Placement create failed, undefined siteСсылка не создана, сайт не определен
4104SAPE.RU: Placement create failed, links limit reachedСсылка не создана, достигнут предел размещенией
4105SAPE.RU: Placement create failed, page is not activeСсылка не создана, страница не активирована
4106SAPE.RU: Placement create failed, site is not activeСсылка не создана, сайт не активирован
4107SAPE.RU: Placement create failed, self link (anchor_url==site_url)Ссылка не создана, является внутренней
4108SAPE.RU: Placement create failed, link already existsСсылка не создана, данная ссылка уже существует
4109SAPE.RU: Placement create failed, IN WM BLСсылка не создана, URL в блэклисте вебмастера
4110SAPE.RU: Placement create failed, IN SEO BLСсылка не создана, сайт в блэклисте оптимизатора
4111SAPE.RU: Placement create failed, text errorСсылка не создана, ошибка текста
4112SAPE.RU: Placement create failed, not enough money for 2 daysСсылка не создана, не достаточно средств на 2 дня размещения
4113SAPE.RU: Placement context create failed, anchor text errorКонтекстная ссылка не создана, ошибка в тексте анкора
4114SAPE.RU: Placement context create failed, sql errorКонтекстная ссылка не создана, SQL-ошибка
4116SAPE.RU: Placement context create failed, no snippetКонтекстная ссылка не создана, отсутствует сниппет
4117SAPE.RU: Placement get good text failed, there are stop wordsТекст не подобран, присутствуют стоп-слова
4118SAPE.RU: Placement get good text failed, there are russian charsТекст не подобран, присутствуют русские буквы
4119SAPE.RU: Placement get good text failedТекст не подобран
4120SAPE.RU: Placement get good text failed, no active anchor textsТекст не подобран, нет активных текстов
4510SAPE.RU: URL unsleep failed :o(URL не восстановлен
4511SAPE.RU: URL unsleep failed, no money :o(URL не восстановлен, не хватает денег
4512SAPE.RU: URL unsleep failed, no links to unsleep :o(URL не восстановлен, нет ссылок для восстановления
6651SAPE.RU: Not wizard user accountЭтот аккаунт не пользуется визардом
6661SAPE.RU: Authorization by password or md5 is prohibited. Please use token instead (Details: https://help.sape.ru/sape/faq/1685). To generate token visit https://passport.sape.ru/security/token/.Авторизация по паролю или md5 запрещена. Пожалуйста, используйте токен (Подробнее: https://help.sape.ru/sape/faq/1685). Сгенерировать токен можно в вашем аккаунте: https://passport.sape.ru/security/token/
7000SAPE.RU: Too deep :o(Уточните условия поиска
7001SAPE.RU: Too short word :o(Слишком короткое слово
7002SAPE.RU: Quantity of calls to a method is exceededКоличество обращений к методу исчерпано
7003SAPE.RU: Search result is too big :o(Слишком много данных в результате поиска, уточните условия
41021SAPE.RU: Placement create failed, zero priceСсылка не создана, цена нулевая
41031SAPE.RU: Placement create failed, site is not salingСсылка не создана, на сайте отключена продажа ссылок
41181SAPE.RU: Placement get good text failed, there are not russian charsТекст не подобран, отсутствуют русские буквы
41301SAPE.RU: Placement create failed, undefined teaser pageСсылка не создана, тизерная страница не определена
41302SAPE.RU: Placement create failed, not enough trafficСсылка не создана, недостаточно трафика на странице
41304SAPE.RU: Placement create failed, not enough traffic on siteСсылка не создана, недостаточно трафика на сайте