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

Перед тем как вы начнёте добавлять пары обмена и настраивать курсы, необходимо правильно настроить сам парсер BestChange API. Эти настройки задают, как именно будут подтягиваться курсы и какие данные использовать по умолчанию.

Где это настроить?

  1. Перейдите в раздел «Парсер курсов — BestChange API парсер».

  2. В правом верхнем углу нажмите на иконку настроек (⚙️).

  3. Заполните все поля по шагам, описанным ниже.

Шаг 1. Включение парсера и API-ключ

Включить парсер

  • Обязательно включите переключатель, чтобы активировать парсер.

    Без этого система не будет обновлять курсы

API Ключ

  • Введите ваш персональный API-ключ, который вы получили в кабинете BestChange.

  • Этот ключ позволяет системе подключаться к API BestChange и загружать данные.

Как получить ключ BestChange API?

Таймер (в секундах)

  • Интервал между запросами к API при ручном запуске.

  • Рекомендуется: 10–30 секунд.

После этого нажмите «Сохранить», чтобы система проверила и подгрузила все данные.

Шаг 2. Выбор версии сайта

Здесь выбираете язык и регион сайта BestChange, с которого будут браться курсы:

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

  • English — если вы работаете на международный рынок.

Курсы, валюты и список обменников могут отличаться между этими версиями. Выбирайте ту, где размещён ваш обменник.

Шаг 3. Тип позиции

Настройка «Тип позиции» влияет на то, как именно парсер выбирает курс из списка обменников на BestChange. От этого зависит, насколько точным будет попадание вашего обменника в нужную вам позицию.

При выборе позиции (например, 3-я или 5-я строка на BestChange) система может учитывать либо только курс, либо курс и рейтинг обменника. Рассмотрим оба варианта подробнее:.

Вариант 1: Rate (только курс)

(Стандартный, наиболее распространённый вариант)

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

Преимущества:

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

  • Парсер быстро и точно находит нужную позицию.

Недостатки:

  • Вы можете получить курс от обменника с низким рейтингом или плохой репутацией на BestChange.

  • Возможно попадание менее надёжного обменника в вашу подборку.

Когда стоит выбрать Rate?

Вариант 2: RankRate (курс + рейтинг)

(Продвинутый режим с учётом репутации обменников)

При выборе этого варианта система сначала учитывает рейтинг и репутацию обменников на BestChange, а затем уже курс. Таким образом, курс будет искаться не просто выгодный, но ещё и от надёжных обменников, которые имеют высокий рейтинг и хорошую репутацию.

Преимущества:

  • Вы защищены от ненадёжных обменников с низким рейтингом.

  • Более стабильная работа с проверенными партнёрами на BestChange.

Недостатки:

  • Курс может оказаться менее выгодным по сравнению с вариантом «Rate».

  • Система может пропустить некоторые позиции, если там будут ненадёжные обменники.

Когда стоит выбрать RankRate?

Если вам важна репутация обменников и качество обменов, даже в ущерб точности попадания в позицию по курсу.

Итоговые рекомендации:

  • Выберите «Rate», если приоритет — это выгодный курс и точность позиции.

  • Выберите «RankRate», если важнее всего качество обменников и надёжность операций.

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

Шаг 4. Позиция по умолчанию

Это строка в списке обменников на BestChange, под которую система будет подгонять курс по умолчанию (если не указано в паре обмена).

Примеры:

  • 3 — курс подбирается под 3-е место.

  • 1-4 — случайно подбирается позиция между 1 и 4 при каждом обновлении.

Если вы укажете позицию в самой паре обмена, эта настройка будет проигнорирована.

Шаг 5. Выбор валют

После того, как вы ввели API-ключ и сохранили базовые настройки, система загрузит с BestChange полный список доступных валют и криптовалют. Вам нужно будет выбрать из этого списка только те валюты, с которыми ваш обменник действительно работает или планирует работать.

Зачем выбирать валюты?

  • Парсер будет получать курсы только по тем направлениям, которые вы выбрали.

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

Как правильно выбрать валюты?

Выбирайте валюты в зависимости от того, с чем вы реально работаете:

  • Электронные деньги (например, QIWI, ЮMoney, WebMoney).

  • Банковские карты и платежные системы (Visa, Mastercard, Сбербанк, Тинькофф и др.).

  • Криптовалюты (Bitcoin, Ethereum, Litecoin и т.д.).

  • Наличные (рубли, доллары, евро и т.д.).

Примеры выбора валют:

  • Вы хотите обменивать Bitcoin на рубли через карты Сбербанка и Тинькофф: выберите валюты Bitcoin (BTC) и Сбербанк RUB, Тинькофф RUB.

  • Вы хотите обменивать Ethereum на наличные доллары и евро: выберите валюты Ethereum (ETH) и наличные валюты USD, EUR.

Важные рекомендации по выбору валют:

  • Не выбирайте валюты, которые не используете — это ускорит работу системы и упростит вам дальнейшую настройку.

  • Если вы планируете работать с новой валютой в будущем, её можно будет добавить позже — список всегда доступен для редактирования.

Шаг 6. Выбор городов (только для наличных обменов)

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

Почему важно выбрать города?

Для наличных операций на BestChange существуют отдельные списки курсов, которые зависят от города. Например, курс обмена наличных в Москве может значительно отличаться от курса обмена в Санкт-Петербурге.

  • Если город указан — парсер получит курс именно для указанного города.

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

Как правильно выбрать города?

Выбирайте города, в которых:

  • У вас есть реальный пункт обмена наличных средств.

  • Вы готовы проводить операции с клиентами лично или через своих курьеров.

Например:

  • Если у вас обменный пункт наличных только в Москве — выберите только город Москва.

  • Если вы работаете с клиентами в нескольких городах (Москва, Казань, Екатеринбург) — выберите все эти города из списка.

Важные рекомендации по городам:

  • Не выбирайте города, в которых вы не ведёте реальной деятельности — это только усложнит работу системы и приведёт к некорректному отображению курса.

  • Список городов можно изменить в любой момент. Если вы откроете пункт в новом городе — просто добавьте его позже в настройках.

Шаг 7. Списки обменников (Белый и Чёрный список)

Эти настройки позволяют вам очень гибко контролировать, с каких именно обменников будут браться курсы при парсинге с BestChange. Вы можете задать списки обменников, которые будут всегда использоваться (белый список) или наоборот — всегда исключаться (чёрный список).

Чёрный список обменников (исключения)

Обменники, добавленные в этот список, будут полностью проигнорированы системой при парсинге курсов.

Когда полезно использовать?

  • Если вы столкнулись с обменником, который даёт некорректный курс.

  • Если обменник часто меняет условия, резервы или ненадёжный в работе.

  • Если вы хотите исключить конкретных конкурентов.

Пример использования:

Вы добавляете ID обменников-конкурентов, чтобы случайно не повторять их курс.

Белый список обменников (приоритетные)

Если заполнен белый список, то парсер будет брать курсы только от указанных обменников. Остальные обменники, даже если у них лучший курс, будут полностью проигнорированы.

Когда полезно использовать?

  • Если у вас есть собственная сеть обменников и вы хотите брать курсы только из них.

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

Пример использования:

Вы доверяете только двум-трём крупным обменникам и хотите использовать исключительно их курсы, добавляете их ID в белый список.

Как списки работают вместе?

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

Совет

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

Шаг 8. Запись логов ошибок

Эта настройка включает ведение журнала (лога) ошибок парсера.

Шаг 9. Автоматическое обновление (Таймер обновления курсов)

Эта настройка задаёт интервал, с какой периодичностью система будет автоматически обновлять курсы по направлениям обмена.

Как выбрать подходящий интервал?

Интервал
Когда использовать?

Каждые 10–20 секунд

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

Каждые 30 секунд

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

Каждую минуту

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

Важные моменты по автообновлению:

  • Чем чаще интервал обновления — тем точнее и актуальнее курсы, но выше нагрузка на сервер и на API BestChange.

  • Редкий интервал обновления снижает нагрузку, но может привести к тому, что ваши курсы будут менее конкурентоспособны, особенно при частых изменениях на рынке.

Рекомендуемый интервал для большинства случаев: 30 секунд или 1 минута.

Last updated

Was this helpful?