Настройка BestChange API
Перед тем как добавлять пары и настраивать курсы, нужно один раз правильно настроить глобальные параметры парсера. Эти настройки определяют, как именно система будет получать список предложений с BestChange и по каким правилам выбирать итоговый курс.
Откройте панель управления «Парсер курсов — BestChange API парсер» → нажмите иконку настроек в правом верхнем углу.
Включение парсера и API-ключ
API-ключ
Введите ваш API-ключ, полученный в кабинете BestChange.
Это обязательное поле.
Если ключ неверный или недоступен, справочники (валюты/города/обменники) могут не загрузиться.
Версия сайта
Определяет язык справочников и некоторые особенности списков.
ru — чаще подходит для русскоязычных обменников
en — если работаете на международный рынок
Важно:
Валюты и названия обменников могут отличаться между версиями. Выбирайте ту версию, где размещён ваш обменник.
Тип курса
Настройка «Тип курса» влияет на то, как именно парсер выбирает курс из списка обменников на BestChange. От этого зависит, насколько точным будет попадание вашего обменника в нужную вам позицию.
При выборе позиции (например, 3-я или 5-я строка на BestChange) система может учитывать либо только курс, либо курс и рейтинг обменника. Рассмотрим оба варианта подробнее:.
Вариант 1: Rate (только курс)
(Стандартный, наиболее распространённый вариант)
Если выбран этот вариант, система ориентируется исключительно на текущий курс обмена. Рейтинг обменников, отзывы, репутация и другие параметры не учитываются.
Преимущества:
Простая логика, всегда легко понять, почему выбран именно этот курс.
Парсер быстро и точно находит нужную позицию.
Недостатки:
Вы можете получить курс от обменника с низким рейтингом или плохой репутацией на BestChange.
Возможно попадание менее надёжного обменника в вашу подборку.
Вариант 2: RankRate (курс + рейтинг)
(Продвинутый режим с учётом репутации обменников)
При выборе этого варианта система сначала учитывает рейтинг и репутацию обменников на BestChange, а затем уже курс. Таким образом, курс будет искаться не просто выгодный, но ещё и от надёжных обменников, которые имеют высокий рейтинг и хорошую репутацию.
Преимущества:
Вы защищены от ненадёжных обменников с низким рейтингом.
Более стабильная работа с проверенными партнёрами на BestChange.
Недостатки:
Курс может оказаться менее выгодным по сравнению с вариантом «Rate».
Система может пропустить некоторые позиции, если там будут ненадёжные обменники.
Как считать курс
Это главный блок: он определяет, как система будет выбирать итоговый курс из списка предложений BestChange, если в конкретной паре не задано другое.
По позиции
Система берёт курс с конкретного места в списке BestChange.
Пример:
Позиция = 3 → берётся 3-е предложение сверху
Позиция = 1–4 → система выбирает позицию случайно внутри диапазона, но стабильно по заданному окну (чтобы курс не «скакал» каждое обновление)
Этот режим самый понятный: «хочу курс ровно с позиции №N».
Сколько лучших курсов учитывать
Это число используется только для "Среднее" и "Взвешенное".
Рекомендация:
обычно 3–10
если рынок «шумный» — можно 10–20
слишком большое значение может делать курс «тяжёлым» и менее конкурентным
Позиция в списке (по умолчанию)
Используется только для режима "По позиции", если в паре позиция не задана.
Пример:
3 → берём 3-ю позицию
1–4 → выбираем в диапазоне
Если в конкретной паре вы укажете свою позицию — глобальная позиция не применяется.
Валюты
После того, как вы ввели API-ключ и сохранили базовые настройки, система загрузит с BestChange полный список доступных валют и криптовалют. Вам нужно будет выбрать из этого списка только те валюты, с которыми ваш обменник действительно работает или планирует работать.
Зачем выбирать валюты?
Парсер будет получать курсы только по тем направлениям, которые вы выбрали.
Если валюта не выбрана, то вы не сможете использовать её для создания направлений обмена и получать по ней автоматическое обновление курсов.
Как правильно выбрать валюты?
Выбирайте валюты в зависимости от того, с чем вы реально работаете:
Электронные деньги (например, QIWI, ЮMoney, WebMoney).
Банковские карты и платежные системы (Visa, Mastercard, Сбербанк, Тинькофф и др.).
Криптовалюты (Bitcoin, Ethereum, Litecoin и т.д.).
Наличные (рубли, доллары, евро и т.д.).
Примеры выбора валют:
Вы хотите обменивать Bitcoin на рубли через карты Сбербанка и Тинькофф: выберите валюты Bitcoin (BTC) и Сбербанк RUB, Тинькофф RUB.
Вы хотите обменивать Ethereum на наличные доллары и евро: выберите валюты Ethereum (ETH) и наличные валюты USD, EUR.
Важные рекомендации по выбору валют:
Не выбирайте валюты, которые не используете — это ускорит работу системы и упростит вам дальнейшую настройку.
Если вы планируете работать с новой валютой в будущем, её можно будет добавить позже — список всегда доступен для редактирования.
Города (только для наличных)
Если вы работаете с наличными обменами (например, обмен криптовалюты на наличные рубли), обязательно укажите города, в которых вы предоставляете эту услугу. Без указания городов наличные направления обмена работать не будут.
Почему важно выбрать города?
Для наличных операций на BestChange существуют отдельные списки курсов, которые зависят от города. Например, курс обмена наличных в Москве может значительно отличаться от курса обмена в Санкт-Петербурге.
Если город указан — парсер получит курс именно для указанного города.
Если город не выбран — парсер просто не найдёт курс для направления с наличкой, так как BestChange разделяет курсы наличных направлений по городам.
Как правильно выбрать города?
Выбирайте города, в которых:
У вас есть реальный пункт обмена наличных средств.
Вы готовы проводить операции с клиентами лично или через своих курьеров.
Например:
Если у вас обменный пункт наличных только в Москве — выберите только город Москва.
Если вы работаете с клиентами в нескольких городах (Москва, Казань, Екатеринбург) — выберите все эти города из списка.
Важные рекомендации по городам:
Не выбирайте города, в которых вы не ведёте реальной деятельности — это только усложнит работу системы и приведёт к некорректному отображению курса.
Список городов можно изменить в любой момент. Если вы откроете пункт в новом городе — просто добавьте его позже в настройках.
Ограничение обменников
Этот блок заменяет старую путаницу с «белым списком» и делает логику проще:
вы задаёте разрешённых и исключённых обменников, а затем выбираете режим.
Режим ограничения обменников
Без ограничений — используются все обменники BestChange (кроме исключённых)
Предпочитать — если есть предложения от разрешённых, система возьмёт их; если нет — возьмёт остальных
(это мягкий приоритет)
Только разрешённые — система берёт предложения только из списка разрешённых
(жёсткое ограничение)
Разрешённые обменники
Список обменников, которым вы доверяете или которые хотите использовать первыми.
Исключённые обменники
Обменники, которые нужно игнорировать всегда:
некорректные курсы
подозрительное поведение
конкуренты, которых вы не хотите учитывать
Важно: «исключённые» работают во всех режимах.
Защита от подозрительных предложений
Автоматическая временная блокировка обменников
Записывать логи ошибок
Если включено — все ошибки парсинга будут сохраняться в журнал, чтобы можно было понять причину:
проблемы доступа к API
пустые ответы по парам
ошибки расчёта формул и т. д.
Последнее обновление
Это было полезно?