Настройка BestChange API парсера
Last updated
Was this helpful?
Last updated
Was this helpful?
Перед тем как вы начнёте добавлять пары обмена и настраивать курсы, необходимо правильно настроить сам парсер BestChange API. Эти настройки задают, как именно будут подтягиваться курсы и какие данные использовать по умолчанию.
Перейдите в раздел «Парсер курсов — BestChange API парсер».
В правом верхнем углу нажмите на иконку настроек (⚙️).
Заполните все поля по шагам, описанным ниже.
Обязательно включите переключатель, чтобы активировать парсер.
Без этого система не будет обновлять курсы
Введите ваш персональный API-ключ, который вы получили в кабинете BestChange.
Этот ключ позволяет системе подключаться к API BestChange и загружать данные.
Интервал между запросами к API при ручном запуске.
Рекомендуется: 10–30 секунд.
После этого нажмите «Сохранить», чтобы система проверила и подгрузила все данные.
Здесь выбираете язык и регион сайта BestChange, с которого будут браться курсы:
Русский — используется для обменников, работающих с русскоязычной аудиторией.
English — если вы работаете на международный рынок.
Настройка «Тип позиции» влияет на то, как именно парсер выбирает курс из списка обменников на BestChange. От этого зависит, насколько точным будет попадание вашего обменника в нужную вам позицию.
При выборе позиции (например, 3-я или 5-я строка на BestChange) система может учитывать либо только курс, либо курс и рейтинг обменника. Рассмотрим оба варианта подробнее:.
(Стандартный, наиболее распространённый вариант)
Если выбран этот вариант, система ориентируется исключительно на текущий курс обмена. Рейтинг обменников, отзывы, репутация и другие параметры не учитываются.
Преимущества:
Простая логика, всегда легко понять, почему выбран именно этот курс.
Парсер быстро и точно находит нужную позицию.
Недостатки:
Вы можете получить курс от обменника с низким рейтингом или плохой репутацией на BestChange.
Возможно попадание менее надёжного обменника в вашу подборку.
Если вам важна максимальная точность попадания в позицию и вы ориентируетесь только на цифры (например, для жёсткой конкуренции по цене).
(Продвинутый режим с учётом репутации обменников)
При выборе этого варианта система сначала учитывает рейтинг и репутацию обменников на BestChange, а затем уже курс. Таким образом, курс будет искаться не просто выгодный, но ещё и от надёжных обменников, которые имеют высокий рейтинг и хорошую репутацию.
Преимущества:
Вы защищены от ненадёжных обменников с низким рейтингом.
Более стабильная работа с проверенными партнёрами на BestChange.
Недостатки:
Курс может оказаться менее выгодным по сравнению с вариантом «Rate».
Система может пропустить некоторые позиции, если там будут ненадёжные обменники.
Если вам важна репутация обменников и качество обменов, даже в ущерб точности попадания в позицию по курсу.
Выберите «Rate», если приоритет — это выгодный курс и точность позиции.
Выберите «RankRate», если важнее всего качество обменников и надёжность операций.
Если не уверены — выберите Rate, как наиболее подходящий для большинства случаев.
Это строка в списке обменников на BestChange, под которую система будет подгонять курс по умолчанию (если не указано в паре обмена).
Примеры:
3 — курс подбирается под 3-е место.
1-4 — случайно подбирается позиция между 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. Вы можете задать списки обменников, которые будут всегда использоваться (белый список) или наоборот — всегда исключаться (чёрный список).
Обменники, добавленные в этот список, будут полностью проигнорированы системой при парсинге курсов.
Если вы столкнулись с обменником, который даёт некорректный курс.
Если обменник часто меняет условия, резервы или ненадёжный в работе.
Если вы хотите исключить конкретных конкурентов.
Пример использования:
Вы добавляете ID обменников-конкурентов, чтобы случайно не повторять их курс.
Если заполнен белый список, то парсер будет брать курсы только от указанных обменников. Остальные обменники, даже если у них лучший курс, будут полностью проигнорированы.
Если у вас есть собственная сеть обменников и вы хотите брать курсы только из них.
Если вы доверяете ограниченному числу обменников и не хотите использовать другие источники курсов.
Пример использования:
Вы доверяете только двум-трём крупным обменникам и хотите использовать исключительно их курсы, добавляете их ID в белый список.
Если одновременно заполнены белый и чёрный списки, то система будет работать только с белым списком (чёрный список будет полностью игнорироваться).
Если вы не уверены в обменниках, начните с пустых списков и постепенно добавляйте обменники в чёрный или белый список, исходя из опыта.
Эта настройка включает ведение журнала (лога) ошибок парсера.
Эта настройка задаёт интервал, с какой периодичностью система будет автоматически обновлять курсы по направлениям обмена.
Каждые 10–20 секунд
Для направлений с высокой волатильностью курсов, например, криптовалюты, где цены меняются быстро.
Каждые 30 секунд
Универсальный вариант для большинства обменников, позволяет сохранять актуальность без лишней нагрузки.
Каждую минуту
Для направлений с низкой волатильностью (например, обмен банковских карт или электронных денег). Это самый стабильный и экономичный вариант.
Чем чаще интервал обновления — тем точнее и актуальнее курсы, но выше нагрузка на сервер и на API BestChange.
Редкий интервал обновления снижает нагрузку, но может привести к тому, что ваши курсы будут менее конкурентоспособны, особенно при частых изменениях на рынке.