Разместите живые крипто-инструменты Bitculator прямо на своём сайте с помощью одного <iframe> — график цен в реальном времени, конвертер, флиппер по капитализации и шесть калькуляторов. Без SDK, без сборки.
9 виджетовКлюч встраивания + доменАнонимный режим
Каждый виджет — это самодостаточная страница по адресу /{locale}/embed/…, которую вы встраиваете на свой сайт через <iframe>. Она отображает живые рыночные данные Bitculator — тот же поток, что использует приложение — и не требует JavaScript на вашей стороне.
Добавьте свой ключ встраивания как параметр запроса и зарегистрируйте домен, на котором будете встраивать (оба шага — в вашей консоли разработчика). Виджеты без ключа тоже работают в анонимном режиме — удобно для быстрой проверки — но ограничены по IP посетителя. Каждый виджет учитывает {locale} в URL и следует cookie theme (или ?theme=dark).
Content-Security-Policy
Отдаёте Content-Security-Policy на своём сайте? Добавьте https://bitculator.com в frame-src (и в child-src для старых браузеров), чтобы виджет мог загрузиться. С нашей стороны менять ничего не нужно — Bitculator уже разрешает встраивание на любом домене.
Ключ встраивания — это токен с правом api, созданный в вашей консоли разработчика. В отличие от ключей Data API, он передаётся в URL iframe как параметр запроса — никогда в заголовке — поэтому по своей природе публичен. Он несёт только право api; ключи data-api (только Bearer) здесь отклоняются, чтобы они не утекли в referer или логи.
Передавайте его как ?embed_key=… (или через алиас ?api_key=…). Запрос с ключом также должен приходить с домена из списка разрешённых (см. ниже). Если вы вошли в Bitculator в том же браузере, проверка ключа для вашей собственной сессии пропускается.
Домены
Виджет с ключом отображается только на доменах, которые вы зарегистрировали. Bitculator считывает Referer встраивающей страницы (с откатом на Origin), нормализует его (в нижний регистр, убирает www. и любую завершающую точку) и точно сопоставляет со списком разрешённых. Незарегистрированный или нечитаемый хост возвращает 403.
Управляйте доменами в вашей консоли разработчика; каждый тариф допускает определённое их число (ниже). Поскольку Referer/Origin задаётся браузером посетителя и может быть подделан, список разрешённых — это защита от случайного повторного использования ключа, а не криптографическое доказательство — в любом случае считайте ключ публичным. Анонимные (без ключа) виджеты не ограничены по домену; вместо этого они ограничены по IP.
Квота и лимиты
Виджеты используют месячный пул, полностью отдельный от Data API — собственный тариф, собственный счётчик. Анонимные загрузки считаются по IP посетителя (1,000/месяц); загрузки с ключом засчитываются в месячный лимит вашего тарифа. Бесплатные тарифы сбрасываются по календарному месяцу; платные — в день вашего биллинга.
*Ответы виджетов не несут заголовков `X-Quota-** — намеренно, чтобы числа квоты никогда не утекали на страницы ваших посетителей. Вместо этого следите за использованием в [консоли разработчика](/user/developer/api). (ЗаголовкиX-Quota-*`, которые вы могли видеть, есть только у Data API.)
Превышение лимита
Когда виджет превышает квоту, он возвращает 429. В браузерном iframe это небольшая оформленная страница «достигнут лимит использования» (чтобы ваша вёрстка не ломалась); JSON-клиент получает {"message", "limit", "used"}. Добавьте ключ или повысьте тариф, чтобы получить больше.
Тарифы
Тарифы виджетов отделены от вашего тарифа Data API. Каждый аккаунт начинает с Free; посетители без ключа получают анонимный уровень.
Тариф
Загрузок / месяц
Домены
Ключи
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Анонимный
1,000 на IP
—
—
Анонимный — это уровень без ключа: ни доменов, ни ключей, ограничен по IP посетителя. Повысьте тариф в консоли разработчика.
Виджеты
Девять готовых виджетов. Скопируйте сниппет, подставьте свой ключ, зарегистрируйте домен — готово. Сегменты пути (например, slug монеты) разрешаются по slug актива и должны быть активным рынком; каждый виджет также принимает общие параметры запроса ниже.
GET
Конвертер валют
/{locale}/embed/converter/bitcoin/usd
Конвертируйте сумму между любыми двумя крипто- или фиатными активами по живым рыночным курсам, с опциональной таблицей сравнения.