Встраиваемые виджеты цен

Обзор

Виджеты — это готовые табло с ценами, которые вы настраиваете в личном кабинете и встраиваете на любой сайт. Они загружаются напрямую с MetalAPI, поэтому писать серверный код не нужно, а ваш ключ API никогда не появляется на странице.

Виджеты есть на всех тарифах: 1 на Free, 3 на Lite, 10 на Standard и до 500 на Enterprise. Примеры можно посмотреть на странице виджетов.

Создание виджета

1. Войдите в аккаунт и откройте раздел Widgets в личном кабинете.
2. Создайте новый виджет и дайте ему название.
3. Выберите символы для отображения (металлы, энергоносители, валюты или криптовалюты) и валюту, в которой будут показаны цены.
4. Выберите макет и тему оформления, затем сохраните виджет.
5. Скопируйте код для встраивания.

Встраивание на сайт

Вставьте код для встраивания из личного кабинета туда, где должен появиться виджет. Виджеты загружаются с metalapi.com/embed/… и могут встраиваться во фрейм на любом сайте, поэтому работают и на обычных HTML-страницах, и в WordPress, и в темах Shopify, и в конструкторах сайтов. Код для встраивания выглядит так:

<iframe
  src="https://metalapi.com/embed/YOUR_WIDGET_ID"
  title="Live precious metal prices"
  width="100%"
  height="320"
  style="border:0"
  loading="lazy"
></iframe>

Используйте именно тот фрагмент кода, который указан в личном кабинете: он содержит идентификатор вашего виджета.

Обновление виджета

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

Когда лучше использовать API

Виджеты решают типичную задачу — показ цен. Если вам нужен собственный дизайн, расчёты или цены внутри приложения, вызывайте API со своего сервера или из браузера с ключом, ограниченным по доменам.