変更履歴
埋め込みウィジェットに対するすべての変更 - URL、パラメータ、キー、ドメイン、制限 - を新しい順に掲載しています。バージョン内で何が安定して維持されるかはポリシーに記載しています。
ウィジェットは Bitculator への WebSocket 接続を開かなくなり、訪問者のブラウザストレージに翻訳データを書き込むこともなくなりました。画面上の表示は変わりません: ウィジェットはもともとライブ価格をストリーミングしていなかったため、数値は常にページ読み込み時点のものです。
複利期間の途中で終わる期間でも、按分で利息が付き、その期間内に行われた入金も計上されるようになりました。また、成長曲線は経過時間に応じた間隔で描かれます。入力値には上限があり、元本は 1,000,000,000,000、積立額は 1,000,000,000、利率は 1,000%、期間は 50 年または 600 か月です。上限を超えた値は上限値にリセットされます。
利率は年間の名目利率となり、複利期間に分割して適用されるようになりました。以前は利率全体が各期間に適用されていたため、年 5% を毎月複利にすると毎月 5% のペースで増えていました。既存の埋め込みの結果は、それに応じて下がります。
有料の埋め込みプランをキャンセルすると、予約していたダウングレードも取り消されるようになりました。プランはそのまま支払い済み期間の終了まで継続します。
DCA の開始日と終了日のピッカーは日付を UTC の午前 0 時として読み取っていたため、UTC より西にいる訪問者には前日が表示されていました。現在は訪問者のローカルの暦日を使用します。
{locale} パスセグメントは、9 月 19 日から 24 日にかけて追加された ar（右から左に表示）、sk、th、ko、ro、hu、sr、fi も受け付けるようになり、合計 27 言語になりました。
ウィジェットページは、セッションクッキーや XSRF クッキーを設定しなくなり、訪問者のブラウザにサービスワーカーを登録することもなくなりました。キーなしの訪問者ごとのカウンターは IP アドレスの鍵付きハッシュを使用するようになり、リファラーのないキーなしの読み込みは、IP ではなく「ダイレクト」として報告されます。
/embed/zoom/{slug} の月次と週次の行は、セッショントークンなしで取得されるようになりました。他のサイトの iframe 内にあるウィジェットは、セッショントークンを取得できないためです。
どちらかの資産に使用可能な価格がない場合、コンバーターは「1 X = 0 Y」ではなく数値を表示しなくなりました。また、時価総額フリッパーは、ペアに時価総額がない場合、前のペアの数値を新しい名前の下に残すのではなく、数値をクリアするようになりました。
コインの以前のスラッグを使ったウィジェット URL は、現在のスラッグの同じウィジェットへの 301 を返すようになりました。クエリ文字列は embed_key も含めて保持されます。以前は 404 を返していました。
登録するドメインは、ブラウザが URL を読み取るのと同じ方法で解析されます: スキーム、パス、ポート、先頭の www. は除去され、名前は小文字化され、国際化ドメイン名は Punycode に変換されます。ホスト名でないものは拒否されます。埋め込みページの Referer も同じ方法で正規化されます。www 以外のサブドメインには、引き続きそれぞれの登録が必要です。
下位の埋め込みプランへの変更は、支払い済み期間の終了時に適用されるようになりました。以前は、同じ請求間隔でのダウングレードは即座に適用され、期間の途中で月間上限が引き下げられていました。アップグレードは引き続き即時に適用されます。
未知または非アクティブなコインスラッグは、iframe 内に Bitculator サイト全体 - ヘッダー、サイドバー、フッター - を表示するのではなく、「Not Found」というテキストだけのレスポンスを返すようになりました。
埋め込みキーを作成するには、認証済みのメールアドレスが必要になりました。暗号資産ウォレットで作成されたアカウントは対象外です。キーの作成は毎分 10 回までに制限され、既存のキーは引き続き使用できます。
8 月 14 日から、ドメインチェックの結果は「未登録」の結果も含めて 5 分間キャッシュされていたため、追加したばかりのドメインが最大 5 分間 403 を返し続けることがありました。現在キャッシュされるのは一致に成功した結果のみです。ドメインの削除が反映されるまでには、引き続き最大 5 分かかることがあります。
埋め込みコンソールでのキーの最終使用時刻は、最大でも 1 時間に 1 回しか書き込まれなくなり、ウィジェットの読み込みが Bitculator 自身のサイト統計で訪問としてカウントされることもなくなりました。埋め込みの使用量カウントには影響しません。
幅が狭い場合、週次の帯と、年次・四半期・月次の帯が独立してスクロールするようになったため、長い週次の行をドラッグしても短い方の帯が横に引っ張られなくなりました。
7 月 12 日から 16 日にかけて、計算ツールのウィジェットとフリッパーに新しいレイアウトと入力欄が導入され、一部のセクションが削除されました: フリッパーの picker、利息の chart と table、税金とローンの results、そしてステーキングの banner、table、chart です（ステーキングは現在、日次から年次までの報酬をインラインで一覧表示します）。訪問者が保存していた配置はリセットされました。削除されたセクションを指定している layout や visible の値は作り直してください。
ホストページはウィジェットのウィンドウに {type: 'bitculator-embed-host-growable'} を送信できます。するとウィジェットはピッカーを下方向に開き、bitculator-embed-resize で報告する高さにピッカーを含めます。このメッセージがない場合、ピッカーは固定フレーム内のオーバーレイとして開きます。
/embed/zoom/{slug} は、年ごとの年次・四半期・月次・週次リターンを 1 つのグリッドで表示するようになりました。平均の行と勝率のサマリーに加え、四半期の「トルネード」ビューも備えています。以前の四半期・月次・週次のテーブルに代わるもので、外側のカード枠はありません。
埋め込みコンソールに、現在の請求期間の 1 日あたりのリクエスト数のチャートが表示されるようになりました。
/{locale}/pricing/embed は /{locale}/crypto-tools にリダイレクトされるようになりました。このページには、チェックアウト付きのプランピッカーと、スニペットビルダーの横でウィジェットを 1 つずつプレビューできるウィジェットエクスプローラーが追加されました。
このリファレンスは /{locale}/documentation/embed/v1 で公開されました。スニペットビルダー、認証、ドメイン、クォータ、プラン、すべてのウィジェットのパラメータ、クリックで読み込むプレビューを備えています。
埋め込みの読み込みは、独自のプラン、請求期間、カウンターを持つようになりました。Data API は最初の 2 日間、埋め込みプランから消費していました。埋め込みキーの上限にカウントされるのは埋め込みキーのみで、ウィジェット URL に Data API キーや期限切れのキーを使うと 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 が返されるようになりました。以前はドメインチェックがスキップされていました。ブラウザのデフォルトのリファラーポリシーを維持し、iframe に referrerpolicy="no-referrer" を設定しないでください。
毎月 1,000 回の読み込みというキーなしの許容量は、埋め込みドメインごとに 1 つのプールではなく、すべてのサイトのすべてのキーなしウィジェットを通じて、訪問者の IP ごとにカウントされるようになりました。
すべてのウィジェットの下部にあるリンクが、4 月 4 日に削除された後、復活しました。bitculator.com の対応するツールにリンクしており、無効にすることはできません。
ビルダーのスニペットは、素の <iframe> に戻りました。4 月 3 日にコピーされたスニペットには、ラッパー、独立した Powered-by リンク、自動リサイズ用の <script> も含まれていました。同時にウィジェット内のフッターリンクも削除され、5 月 2 日に復活しました。
各ツールページにビルダーが追加されました: 埋め込みキーを貼り付け、ウィジェットの言語、レイアウトテンプレート、表示するセクションを選び、幅、高さ、角の丸み、遅延読み込みか即時読み込みかを設定すると、スニペットとライブプレビューが同時に更新されます。
計算ツールとフリッパーのウィジェットは、デフォルトで表示するセクション ID のカンマ区切りリストである ?visible= を受け付けます。訪問者がブラウザに保存した自分の選択が優先されます。
キーは ?embed_key= として渡してください。?api_key= もエイリアスとして引き続き機能します。コンソールは /{locale}/user/developer/embed に移動し、新しいキーの完全な値は作成直後に一度だけ表示されます。
ウィジェットページは依然として X-Frame-Options: SAMEORIGIN と frame-ancestors 'self' を付けて配信されていたため、ブラウザは他のドメインでの表示を拒否していました。現在は frame-ancestors * を送信し、X-Frame-Options は送信しません。
3 月 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」リンクを備えています。
ウィジェットのバージョンの削除や制限の引き下げは、少なくとも 6 か月前にこのページとメールで告知します - 非推奨化ポリシーをご覧ください。