Документация

Как установить валютный виджет на сайт

Ниже собраны простые инструкции по подключению виджета RubleAPI. Сначала выберите настройки в генераторе, затем получите код и вставьте его на нужную страницу сайта.

Быстрый старт

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

Откройте страницу /widget.
Выберите тип виджета, валюты и оформление.
Скопируйте готовый код для вставки.
Добавьте код на страницу сайта и опубликуйте изменения.

Установка на Tilda

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

<script
  src="https://rubleapi.ru/widget.js"
  data-api-base="https://rubleapi.ru"
  data-symbols="usd,eur,cny"
  data-theme="light"
  data-round="2"
  data-branding="true">
</script>

Установка на WordPress

В редакторе страницы добавьте блок Custom HTML или Произвольный HTML, вставьте туда код виджета и обновите публикацию.

<script
  src="https://rubleapi.ru/widget.js"
  data-api-base="https://rubleapi.ru"
  data-symbols="usd,eur"
  data-theme="dark"
  data-round="2"
  data-branding="true">
</script>

Установка на обычный html-сайт

Вставьте код в нужное место страницы. После загрузки страницы виджет появится рядом с этим кодом.

<div class="rates-block">
  <h2>Курсы валют</h2>
  <script
    src="https://rubleapi.ru/widget.js"
    data-api-base="https://rubleapi.ru"
    data-symbols="usd,eur,cny"
    data-theme="light"
    data-round="2"
    data-branding="true">
  </script>
</div>

Настройка внешнего вида

В генераторе можно выбрать валюты, тему оформления, ширину, размер текста, скругление углов и цвета.

Что можно менять

набор валют
светлую или тёмную тему
ширину виджета
размер текста
скругление углов
цвет фона, текста и акцента

Важно про номинал

Если рядом с валютой указано 10 или 10 000, курс показан за это количество единиц валюты по данным ЦБ РФ. Это уже учитывается в виджете и конвертере.

Частые ошибки

Сервис RubleAPI временно недоступен.
В коде указан неверный адрес сервиса в data-api-base.
В параметрах не выбраны валюты.
В базе пока нет сохранённых курсов.
Браузер или расширение блокирует загрузку данных.
На сайте сохранилась старая версия страницы в кеше.

Виджет можно вставлять на разные сайты. Сервер RubleAPI разрешает таким сайтам получать данные курсов.

Условия бесплатного использования

В бесплатной версии должна сохраняться ссылка «Данные: RubleAPI». Отключение брендинга будет доступно в платной версии.

Готово к установке

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

Открыть генератор