Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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, будет отображаться знак предупреждения. При наведении на данный знак, будет отображаться комментарий "Parser rate invalid rate can't be 0".

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

Last updated