Bestchange API парсер (new, начиная с v2.6)

Модуль доступен начиная с версии 2.6!

Переноса настроек из модуля Bestchange парсер невозможен по техническими причинам, поэтому для использования нового модуля понадобится настроить все курсы заново

Для автоматического обновления курсов валют обязательно создайте задание Cron на сервере, используя ссылку из раздела "BestChange API парсер" -> "Настройки"

Хэш для ссылки для задания cron задается в файле wp-content/plugins/premiumbox/userdata.php

Обратите внимание, что использование Bestchange API парсера не гарантирует вам место в списке обменников на Bestchange, которое вы указываете в настройках парсера.

Модуль доступен для всех обменников, использующих скрипт Premium Exchanger — ваш конкурент может настроить парсер также как и вы, поэтому все обменники, которые используют парсер, будут находиться в борьбе за указанное место (чаще всего это 1-я позиция) в выбранном направлении обмена.

Единственный вариант гарантированного нахождения на первом месте — постоянный демпинг.

Также вы можете дополнительно настроить мин. и макс. курсы по этой инструкции, чтобы случайно не уйти в минус, если другой обменник также решил демпинговать (это потянет вас за ним, если выбрана привязка к первому месту и не настроена опция мин./макс. курсы)

Bestchange API парсер будет работать только в активном направлении обмена — при настройках парсера обязательно сделайте направление активным перед началом настройки

Общие настройки модуля

Домен — укажите в поле один из доменов из списка под самим полем, если при пустом поле (когда парсер использует основной домен BC) парсер не работает (не отображаются валюты и города в списке ниже на этой же странице).

Ключ API — API ключ из ЛК на сайте Bestchange

Таймаут (сек.) — время ожидания ответа от Bestchange (рекомендуемое значение — 20 секунд. Если указан 0, то также применяется значение в 20 секунд)

Site version — языковая версия сайта Bestchange (en или ru)

Позиция: • Rate — базовое значение курса (формула расчета: rate = from_amount / to_amount) • Rankrate — курс с примененными дополнительными комиссиями, рассчитанный для суммы обмена в $300. Этот курс выводится в Bestchange по умолчанию. Если нужно получить рейтинг обменников, отсортированный по курсу обмена как на Bestchange, то лучше использовать rankrate.

Черный список ID обменников (через запятую) — ID обменников, курсы которых будут игнорироваться при парсинге

Как узнать ID обменника?

Кликните на изображение ниже, чтобы увидеть, как найти ID обменника на сайте Bestchange.

Белый список ID обменников (через запятую) — ID обменников, курсы которых будут использоваться при парсинге (если указан хотя бы один ID — парсер будет использовать только курс этого источника, игнорируя остальные обменники)

Удалять старые данные: • Да — данные, полученные от парсера будут удаляться перед каждым новым обновлением курса (если курс по каким-либо причинам не будет обновлен, он будет отображаться как 0 = 0 до следующего успешного обновления курса) • Нет — данные, полученные от парсера не будут удаляться перед каждым новым обновлением курса (если курс по каким-либо причинам не будет обновлен, он будет отображать предыдущее полученное значение до следующего успешного обновления курса)

Отключить защиту: • Да — защита от скачков курса отключена • Нет — защита от скачка курса включена. Для защиты используются данные первых 5 мест в листинге Bestchange для расчета разницы между курсами — курс не может быть больше этой разницы

Описание механизма защиты

Для предотвращения аномальных скачков мы используем данные, полученные от пяти обменников (они выделены подчеркиванием в таблице, открывающейся по кнопке "Показать рейтинг" в настройках Bestchange парсера в направлении обмена). Мы анализируем разницу между этими курсами и устанавливаем ограничение: курс не может превышать максимальную разницу, определенную на основе этих данных.

Ключевые термины:

На скриншоте письмо, отправляемое администратору, если включена защита и активирован e-mail шаблон "Bestchange ошибка безопасности"

• First rate — курс первой позиции среди пяти источников

• Your rate — ваш текущий курс

• Min security rate — минимальный курс, который считается безопасным по нашим расчетам

Причины введения защиты

В прошлом мы сталкивались с ситуациями, когда в Bestchange происходили резкие скачки курса из-за изменения формата представления курса (например, с 1 к XXX на XXX к 1). Для отслеживания таких аномалий была разработана данная защита.

Условия работы защиты

Данная защита будет эффективно работать, если вы добавляете небольшие значения к шагу, например, 0.0001. Если же вы добавляете более значительные значения, например, от 0.5% и выше, то курс уже будет считаться аномальным.

Выберите валюты — список доступных валют с Bestchange для парсинга (список будет отображаться только после указания валидного API ключа в настройках парсера)

Выберите города — список городов с Bestchange для парсинга (список будет отображаться только после указания валидного API ключа в настройках парсера)

Настройки парсера в направлении обмена

В панели управления в разделе "Направления обменов" → "Направления обменов" перейдите к редактированию направления обмена.

На вкладке "Автокорректировка курса" и "Bestchange парсер" перед началом настройки BestChange API парсера отключите любые действующие автокорректировки курса, если такие настройки используются.

На вкладке "BestChange API парсер" вы увидите блок настроек. Выполните необходимые настройки:

Включить парсер: • Да — парсер включен в направлении обмена • Нет — парсер не используется

Для активации парсера обязательно требуется выбрать 2 валюты в полях "Валюты (Отдаете)" и "Валюты (Получаете)"

Черный список ID обменников (через запятую) — ID обменников, курсы которых будут игнорироваться при парсинге

Белый список ID обменников (через запятую) — ID обменников, курсы которых будут использоваться при парсинге (если указан хотя бы один ID — парсер будет использовать только курс этого источника, игнорируя остальные обменники)

Если в общих настройках парсера аналогичные поля заполнены, они будет игнорироваться для настроек этого направления обмена — настройки в направлении обмена более высокоприоритетные.

Если в настройках направления обмена поля не заполнены, а общие заполнены, то для направления обмена будут применяться общие настройки.

Город — список городов, которые отмечены галочками в общих настройках парсера (город выбирается для направления обмена с наличными)

Валюты (Отдаете) — выбор валюты для стороны "Отдаете"

Валюты (Получаете) — выбор валюты для стороны "Получаете"

Сторона курса: • Авто — автовыбор стороны курса для значений в полях "Мин.курс" и "Макс. курс" • 1 = XXX — принудительная установка курса 1 к XXX • XXX = 1 — принудительная установка курса XXX к 1

Позиция — позиция из рейтинга Bestchange для выбранного направления обмена (если поле не заполнено, используется 1-я позиция)

Шаг — корректировка курса, полученного от парсера (например 0.001). Система по умолчанию всегда делает ваш курс выгоднее курса указанного значения из поля "Позиция". Также шаг можно задать в виде процента (например 3%).

Значение шага со знаком "-" будет делать ваш курс хуже курса заданной позиции (-0.001 или -3%), также можно использовать умножение и деление (*2 или /2, *3% или /3%)

Мин. резерв для позиции — значение минимального резерва для позиции (для валюты "Получаете"). Обменники, с резервом менее указанного значения, будут игнорироваться модулем

Показать рейтинг — страница с курсами валют из Bestchange и рекомендованным шагом

Мин. курс — предельное нижнее значение курса, до которого будет работать привязка к позиции. Если конкурент по заданной позиции выйдет за рамки минимального курса, то модуль сбросит ваш курс на стандартный (если опция включена).

Если для одной или всех опций ("Минимальный курс", "Максимальный курс", "Стандартный курс" курсы будут указаны как вручную, так и выбраны курсы в опции "Автокорректировка курса", то курс из поля "Автокорректировка курса" всегда будет более высокоприоритетным, именно он будет использоваться для работы парсера

Автокорректировка мин. курса — привязка минимального курса к выбранному источнику из раздела "Парсеры 2.0" -> "Курсы" • Добавляем к курсу — регулировка минимального курса, получаемого из источника (к примеру, прибавление 3% или вычитание -3%)

Макс. курс — предельное верхнее значение курса, до которого будет работать привязка к позиции. Если конкурент по заданной позиции выйдет за рамки максимального курса, то модуль сбросит ваш курс на стандартный (если опция включена).

Автокорректировка макс. курса — привязка максимального курса к выбранному источнику из раздела "Парсеры 2.0" -> "Курсы" • Добавляем к курсу — регулировка максимального курса, получаемого из источника (к примеру, прибавление 3% или вычитание -3%)

Сбрасывать на стандартный курс: • Да — включение опции сброса на стандартный курс при выходе из диапазона мин/макс • Нет — опция не используется

Стандартный курс (Отдаете) — ручное указание стандартного курса для стороны "Отдаете"

Стандартный курс (Получаете) — ручное указание стандартного курса для стороны "Получаете"

Автокорректировка курса — привязка стандартного курса к выбранному источнику из раздела "Парсеры 2.0" -> "Курсы" • Добавляем к курсу (Отдаете) — регулировка максимального курса, получаемого из источника (к примеру, прибавление 3% или вычитание -3%) для стороны "Отдаете" • Добавляем к курсу (Получаете) — регулировка максимального курса, получаемого из источника (к примеру, прибавление 3% или вычитание -3%) для стороны "Получаете"

Преобразовать курс: • Да — принудительное преобразование курса обмена к формату 1 к ХХХ • Нет — опция не используется