Журнал изменений
Каждое изменение встраиваемых виджетов - URL, параметры, ключи, домены и лимиты, сначала новые. Что остаётся стабильным в пределах версии, изложено в политиках.
Виджеты больше не открывают websocket-соединение с Bitculator и не записывают данные переводов в хранилище браузера посетителя. На экране ничего не меняется: виджеты никогда не транслировали живые цены, поэтому цифры всегда актуальны на момент загрузки страницы.
Срок, заканчивающийся посреди периода капитализации, теперь приносит проценты пропорционально и по-прежнему учитывает сделанные в этом периоде взносы, а кривая роста размечена по прошедшему времени. Вводимые значения ограничены: основная сумма - 1 000 000 000 000, взнос - 1 000 000 000, ставка - 1 000%, срок - 50 лет или 600 месяцев; значение выше предела сбрасывается до предела.
Ставка теперь - номинальная годовая, распределяемая по периодам капитализации. Раньше полная ставка применялась к каждому периоду, поэтому 5% при ежемесячной капитализации росли как 5% в месяц; результаты в существующих встраиваниях соответственно уменьшаются.
Отмена платного тарифа встраивания теперь также отменяет любое запланированное вами понижение; тариф просто действует до конца оплаченного периода.
Поля выбора начальной и конечной даты DCA считывали даты как полночь по UTC, из-за чего посетители западнее UTC видели предыдущий день. Теперь они используют местный календарный день посетителя.
Сегмент пути {locale} теперь также принимает ar (отображается справа налево), sk, th, ko, ro, hu, sr и fi, добавленные с 19 по 24 сентября, - всего 27 языков.
Страницы виджетов больше не устанавливают cookie сессии или XSRF и не регистрируют service worker в браузере посетителя. Счётчик на посетителя для загрузок без ключа теперь использует ключевой хеш IP-адреса, а загрузки без ключа и без referrer учитываются как «direct», а не по IP.
Месячные и недельные строки /embed/zoom/{slug} теперь загружаются без токена сессии, который виджет внутри iframe на чужом сайте получить не может.
Конвертер не показывает значение, если у любого из двух активов нет пригодной цены, вместо «1 X = 0 Y», а флиппер капитализации очищает свои цифры, если у пары нет рыночной капитализации, вместо того чтобы оставлять числа предыдущей пары под новыми названиями.
URL виджета со старым slug монеты теперь возвращает 301 на тот же виджет под текущим slug с сохранением строки запроса, включая embed_key. Раньше он возвращал 404.
Зарегистрированные домены разбираются так же, как браузер читает URL: схема, путь, порт и начальный www. отбрасываются, имя приводится к нижнему регистру, а международные имена преобразуются в punycode; всё, что не является именем хоста, отклоняется. Referer встраивающей страницы нормализуется так же. Поддоменам, кроме www, по-прежнему нужна отдельная запись.
Переход на более низкий тариф встраивания теперь вступает в силу по окончании оплаченного периода. Раньше понижение в пределах того же интервала оплаты применялось сразу и урезало месячный лимит посреди периода. Повышения по-прежнему применяются немедленно.
Неизвестный или неактивный slug монеты теперь возвращает простой текстовый ответ «Not Found» вместо отрисовки всего сайта Bitculator - шапки, боковой панели и подвала - внутри вашего iframe.
Создание ключа встраивания теперь требует подтверждённого адреса электронной почты; аккаунты, созданные с криптокошельком, освобождены от этого требования. Создание ключей ограничено 10 в минуту, а существующие ключи продолжают работать.
С 14 августа проверки доменов кешировались на 5 минут, включая результаты «не зарегистрирован», поэтому только что добавленный домен мог ещё до 5 минут возвращать 403. Теперь кешируются только успешные совпадения; удаление домена по-прежнему может вступать в силу до 5 минут.
Время последнего использования ключа в консоли встраивания теперь записывается не чаще раза в час, а загрузки виджетов больше не считаются посещениями в собственной статистике сайта Bitculator. Счётчики использования встраиваний это не затрагивает.
На узких экранах недельная полоса и полоса с годовыми, квартальными и месячными данными теперь прокручиваются независимо, поэтому перетаскивание длинной недельной строки больше не сдвигает более короткую полосу вбок.
С 12 по 16 июля виджеты калькуляторов и флиппер получили новые макеты и поля ввода, а некоторые секции были удалены: picker во флиппере, chart и table в калькуляторе процентов, results в налоговом и кредитном калькуляторах и banner, table и chart в калькуляторе стейкинга, который теперь показывает награды от дневных до годовых прямо в тексте. Сохранённые раскладки посетителей сброшены; пересоберите любое значение layout или visible, в котором упоминается удалённая секция.
Страница-хост может отправить {type: 'bitculator-embed-host-growable'} в окно виджета. Тогда виджет открывает свои элементы выбора вниз и включает их в высоту, которую сообщает через bitculator-embed-resize; без этого сообщения элементы выбора открываются поверх содержимого внутри фрейма фиксированной высоты.
/embed/zoom/{slug} теперь показывает одну сетку годовой, квартальной, месячной и недельной доходности по годам со строкой средних значений и сводками доли прибыльных периодов, а также квартальное представление «торнадо». Она заменяет прежние квартальные, месячные и недельные таблицы и не имеет внешней рамки-карточки.
Консоль встраивания теперь показывает график запросов по дням за текущий расчётный период.
/{locale}/pricing/embed теперь перенаправляет на /{locale}/crypto-tools, где появились выбор тарифа с оформлением оплаты и обозреватель виджетов, показывающий предпросмотр одного виджета за раз рядом с конструктором сниппета.
Этот справочник открылся по адресу /{locale}/documentation/embed/v1 - с конструктором сниппета, аутентификацией, доменами, квотой, тарифами, параметрами каждого виджета и предпросмотрами, загружаемыми по клику.
У загрузок виджетов теперь собственный тариф, расчётный период и счётчик; в первые два дня Data API расходовал тариф встраивания. В лимит ключей встраивания засчитываются только ключи встраивания, ключ Data API или просроченный ключ в URL виджета получает 403, а ответы виджетов не содержат заголовков X-Quota-*.
После отмены платного тарифа встраивания использование до окончания тарифа продолжает считаться в окне от вашего дня оплаты, а не переключается на календарный месяц посреди периода, и дата сброса в консоли верна для дней оплаты в конце месяца.
Ранние JSON-эндпоинты /api/v1/prices и /api/v1/widgets/convert/{from}/{to}, принимавшие ключ встраивания, заменены Data API, который принимает только собственные ключи. Ключами встраивания управляют на /user/developer/embed.
Хост встраивающей страницы приводится к нижнему регистру и теряет завершающую точку перед сравнением с вашими зарегистрированными доменами.
/{locale}/crypto-tools стала страницей виджетов с живым конвертером, копируемым сниппетом и сравнением Free, Starter и Pro.
Загрузка с embed_key, но без заголовка Referer или Origin теперь получает 403; раньше она пропускала проверку домена. Сохраняйте политику referrer браузера по умолчанию и не задавайте referrerpolicy="no-referrer" для iframe.
Лимит в 1 000 загрузок в месяц без ключа теперь считается на IP посетителя по всем виджетам без ключа на всех сайтах, а не как один пул на встраивающий домен.
Ссылка внизу каждого виджета вернулась после удаления 4 апреля. Она ведёт на соответствующий инструмент на bitculator.com, и её нельзя отключить.
Сниппеты конструктора снова стали простым <iframe>; сниппеты, скопированные 3 апреля, также содержали обёртку, отдельную ссылку Powered by и <script> для автоматического изменения размера. Ссылка в подвале внутри виджета была удалена одновременно с этим и вернулась 2 мая.
На каждой странице инструмента появился конструктор: вставьте ключ встраивания, выберите язык виджета, шаблон раскладки и видимые секции, задайте ширину, высоту, радиус скругления и ленивую или немедленную загрузку - сниппет и живой предпросмотр обновляются вместе.
Виджеты калькуляторов и флиппера принимают ?visible= - список ID секций через запятую, которые показываются по умолчанию. Собственный выбор посетителя, сохранённый в его браузере, имеет приоритет.
Передавайте ключ как ?embed_key=; ?api_key= по-прежнему работает как алиас. Консоль переехала на /{locale}/user/developer/embed, а полное значение нового ключа показывается один раз, сразу после создания.
Страницы виджетов всё ещё отдавались с X-Frame-Options: SAMEORIGIN и frame-ancestors 'self', поэтому браузеры отказывались показывать их на других доменах. Теперь они отправляют frame-ancestors * и не отправляют X-Frame-Options.
Тарифы, введённые 22 марта, стали тарифами встраивания с собственным оформлением оплаты, а страница цен переехала на /{locale}/pricing/embed. Лимиты не изменились.
Виджеты DCA, прибыли, процентов, налогов, кредита, стейкинга и флиппер разделены на секции, которые посетители могут перетаскивать, менять в размере и выравнивать; раскладка сохраняется в их браузере, и есть кнопка «Сбросить макет». ?layout= задаёт начальную раскладку, например c(stats::cc,settings::cc), где c() - колонка, r() - строка, а секция записывается как id:width:alignment.
Виджеты принимают ключ в URL, и загрузка с ключом должна приходить с домена, зарегистрированного в консоли, иначе получает 403; загрузки без ключа по-прежнему отображаются. Free допускает 10 000 загрузок в месяц, 1 домен и 2 ключа, Starter - 50 000, 3 и 5, а Pro - 500 000, 10 и 10. При превышении лимита виджет показывает страницу лимита использования (HTTP 429).
Виджет конвертера лишился таблицы сравнения, поэтому с тех пор hideTable ни на что не влияет. Параметр по-прежнему принимается.
Виджеты отправляют {type: 'bitculator-embed-resize', height} родительскому окну при каждом изменении своей высоты, чтобы скрипт на странице-хосте мог подогнать размер iframe, и показывают заглушку загрузки, пока не будут готовы. На каждой странице инструмента появился копируемый сниппет для встраивания.
Запуск: конвертер (/{locale}/embed/converter/{from}/{to}), zoom (/zoom/{slug}), флиппер капитализации (/flip/{entity1}/{entity2}) и калькуляторы /dca, /profit, /interest, /tax, /loan и /staking. Каждый виджет принимает ?compact=1 и ?theme=dark, имеет прозрачный фон, помечен noindex и содержит ссылку «Powered by Bitculator».
Удаление версии виджета или снижение лимита объявляется здесь и по электронной почте не менее чем за шесть месяцев - см. политику устаревания.