BestChange v2

Инструкция по настройке парсера BestChange v2

Установка парсера

Используя параметры ниже, установите парсер через функционал "Install plugin" по инструкции Install plugin.

Параметры для Install Plugin

Plugin type: Parser-rate module

Plugin URL: @boxexchanger-plugins/parser-bestchange-v2

Directory path: bestchange-v2

Auth: (Deploy token): оставляем пустым

Package tag: latest

Настройка парсера

1. Для запуска парсера, следуйте инструкции Конфигурация парсера.

Для применения изменений в поле, необходимо соглашаться с перезагрузкой процессов сервера.

1. В поле "api_key" укажите API ключ (см. уточнение ниже) для получения курсов обмена -> нажмите "Применить изменения (API_KEY).

API ключ для получения курсов обмена вы можете сгенерировать в ЛК BestChange по ссылке: https://www.bestchange.ru/partner/profile.html. На странице "Профиль" - в разделе "API для получения курсов обмена", согласитесь с условиями использования BestChange -> нажмите "" -> API ключ.

1. Поле "batch" рекомендуем оставлять без изменений. Значение в данном поле отвечает за количество курсов, которое будет обрабатываться в одном API запросе. Максимальное значение: 500.

2. В поле "places" укажите места по которым необходимо получить курсы. К примеру, если необходимо получить курсы по 1,2 и 4 месту из списка BestChange по паре - введите 1,2,4 -> нажмите "Применить изменения (PLACES)"

3. В поле "routes" введите пары, по которым необходимо получить курсы. Подробнее о формате и особенностях ввода пар:

Обратите внимание, в качестве XML для валют и городов необходимо использовать сигнатуры, представленные на странице BestChange: https://www.bestchange.ru/wiki/rates.html

• Особенности при указании пар: а) Безналичные валюты: XML1_XML2. К примеру, для того чтобы получить курсы по паре USDT TRC20 -> Monobank UAH необходимо ввести USDTTRC20_MONOBUAH б) Наличные валюты: XML1_XML2-CITY. К примеру, для того чтобы получить курсы по паре Cash USD KIEV -> USDT TRC20 необходимо ввести CASHUSD_USDTTRC20-KIEV

• Пары необходимо разделять запятой (,). Пример: USDTTRC20_MONOBUAH,CASHUSD_USDTTRC20-KIEV,BTC_USDTTRC20

-> нажмите "Применить изменения (ROUTES)".

1. В поле "cityKey" укажите формат отображения названия города в паре: а) Значение name (по умолчанию). При таком параметре, название города в админ панели будет отображаться как имя города на английском языке, которое указано на странице BestChange. К примеру, если в поле "routes" ввести CASHUSD_USDTTRC20-WRCL, то в админ панели пара будет отображаться как TOP_1 - CASHUSD - WROCLAW -> USDTTRC20. б) Значение code. При таком параметре, название города в админ панели будет отображаться как сигнатура города, которая указана на странице BestChange. К примеру, если в поле "routes" ввести CASHUSD_USDTTRC20-WRCL, то в админ панели пара будет отображаться как TOP_1 - CASHUSD - WRCL -> USDTTRC20. -> нажмите "Применить изменения (CITYKEY)".

В случае изменения формата отображения города в поле "cityKey" при условии, что парсер активен и в нем существуют пары - существующие курсы с предущим названием города перестанут обновляться, однако будут добавлены новые курсы, которые указаны в поле "routes" с обновленным названием города.

1. В поле "sourceRate" укажите источник курса: а) Значение bestchange.ru. При таком параметре курсы будут парситься из русскоязычной версии BestChange. б) Значение bestchange.com. При таком параметре курсы будут парситься из англоязычной версии BestChange.

2. В поле "Интервал" укажите в миллисекундах частоту обновления курсов. Рекомендуемое значение: 15000 -> нажмите "Применить изменения (INTERVAL)".

3. В поле "ignoreChangerIds" вы можете указать BestChange id обменных сервисов, курсы которых будут игнорироваться при парсинге.

Обязательно добавьте в поле "ignoreChangerIds" BestChange Id вашего обменного сервиса. Данный шаг необходим для того чтобы парсер игнорировал курс вашего обменника при получении курсов и учитывал лишь курсы ваших конкурентов.

1. Парсер настроен.

Перед использованием парсера также ознакомьтесь с разделом Приоритетность обновлений курсов для понимания порядка обновления курсов.

Валидация курсов

В случае, если на BestChange отсутствуют курсы по паре, указанной в поле "routes" -> система установит курс 0 для такой пары.

• На клиентской части, направление с курсом 0 будет отображаться, однако станет для создания заявки.

• В админ панели на странице "Настройка направлений" - в поле с направлением, у которого выставлен курс 0, будет отображаться знак предупреждения. При наведении на данный знак, будет отображаться комментарий "".

• В случае, если на BestChange курс по паре появится, то в парсере курс автоматически обновится и направление будет снова доступно для создания заявки на клиентской части. В админ панели, в свою очередь, курс также обновится и пропадет знак предупреждения.