Журнал змін
Кожна зміна віджетів для вбудовування - 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.
Створення embed-ключа тепер вимагає підтвердженої адреси електронної пошти; облікові записи, створені з криптогаманцем, звільнено від цієї вимоги. Створення ключів обмежено 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 витрачав тариф вбудовування. До ліміту embed-ключів зараховуються лише embed-ключі, ключ Data API або прострочений ключ в URL віджета отримує 403, а відповіді віджетів не містять заголовків X-Quota-*.
Після скасування платного тарифу вбудовування використання до завершення тарифу й надалі рахується у вікні від вашого дня оплати, а не перемикається на календарний місяць посеред періоду, і дата скидання в консолі правильна для днів оплати наприкінці місяця.
Ранні JSON-ендпоінти /api/v1/prices і /api/v1/widgets/convert/{from}/{to}, що приймали embed-ключ, замінено Data API, який приймає лише власні ключі. Embed-ключами керують на /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 травня.
На кожній сторінці інструмента з'явився конструктор: вставте свій embed-ключ, виберіть мову віджета, шаблон розкладки та видимі секції, задайте ширину, висоту, радіус заокруглення та ліниве чи негайне завантаження - фрагмент коду й живий попередній перегляд оновлюються разом.
Віджети калькуляторів і фліпера приймають ?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».
Про видалення версії віджета чи зниження ліміту оголошується тут і електронною поштою щонайменше за шість місяців - див. політику застарівання.