Tempatkan alat kripto live Bitculator langsung di situs Anda hanya dengan satu <iframe> — grafik harga real-time, konverter, flipper marketcap, dan enam kalkulator. Tanpa SDK, tanpa langkah build.
9 widgetEmbed key + domainMode anonim
Setiap widget adalah halaman mandiri di bawah /{locale}/embed/… yang Anda tempatkan di situs Anda dengan sebuah <iframe>. Ia menampilkan data pasar live Bitculator — feed yang sama dengan yang digunakan aplikasi — dan tidak memerlukan JavaScript di sisi Anda.
Tambahkan embed key Anda sebagai parameter query dan daftarkan domain tempat Anda akan menyematkan (keduanya di konsol developer Anda). Embed tanpa key juga berfungsi dalam mode anonim — praktis untuk uji coba cepat — tetapi dibatasi per IP pengunjung. Setiap widget menghormati {locale} di URL dan mengikuti cookie theme (atau ?theme=dark).
Content-Security-Policy
Menyajikan Content-Security-Policy di situs Anda? Tambahkan https://bitculator.com ke frame-src Anda (dan child-src untuk peramban lama) agar widget dapat dimuat. Tidak ada yang perlu diubah di sisi kami — Bitculator sudah mengizinkan penyematan di domain mana pun.
Embed key adalah token dengan kemampuan api, dibuat di konsol developer Anda. Tidak seperti key Data API, key ini menumpang di URL iframe sebagai parameter query — tidak pernah di header — sehingga bersifat publik secara desain. Ia hanya membawa kemampuan api; key data-api yang hanya-Bearer ditolak di sini agar tidak bocor ke referer atau log.
Kirimkan sebagai ?embed_key=… (atau alias ?api_key=…). Permintaan berkunci juga harus datang dari domain yang ada di daftar izin (lihat di bawah). Jika Anda masuk ke Bitculator di browser yang sama, pemeriksaan key dilewati untuk sesi Anda sendiri.
Domain
Embed berkunci hanya tampil di domain yang telah Anda daftarkan. Bitculator membaca Referer halaman penyemat (kembali ke Origin), menormalkannya (huruf kecil, www. dan titik di akhir dihapus), lalu mencocokkannya persis dengan daftar izin Anda. Host yang tidak terdaftar atau tidak terbaca mengembalikan 403.
Kelola domain di konsol developer Anda; setiap paket mengizinkan jumlah tertentu (di bawah). Karena Referer/Origin ditetapkan oleh browser pengunjung dan dapat dipalsukan, daftar izin adalah pelindung terhadap penggunaan ulang key secara sembarangan, bukan bukti kriptografis — perlakukan key sebagai publik bagaimanapun juga. Embed anonim (tanpa key) tidak dibatasi domain; sebagai gantinya dibatasi per IP.
Kuota & batas
Embed mengambil dari kumpulan bulanan yang sepenuhnya terpisah dari Data API — paketnya sendiri, penghitungnya sendiri. Pemuatan anonim dihitung per IP pengunjung (1,000/bulan); pemuatan berkunci dihitung terhadap batas bulanan paket Anda. Paket Free direset pada bulan kalender; paket berbayar direset pada hari penagihan Anda.
*Respons embed tidak membawa header `X-Quota-** — secara sengaja, agar angka kuota tidak pernah bocor ke halaman pengunjung Anda. Sebagai gantinya, pantau penggunaan Anda di [konsol developer](/user/developer/api). (HeaderX-Quota-*` yang mungkin pernah Anda lihat hanya ada di Data API.)
Melebihi batas
Ketika widget melampaui kuota, ia mengembalikan 429. Di iframe browser, itu berupa halaman kecil bergaya "batas penggunaan tercapai" (agar tata letak Anda tidak rusak); pemanggil JSON mendapat {"message", "limit", "used"}. Tambahkan key, atau tingkatkan paket Anda, untuk lebih banyak.
Paket
Paket embed terpisah dari paket Data API Anda. Setiap akun dimulai pada Free; pengunjung tanpa key mendapat tier anonim.
Paket
Pemuatan / bulan
Domain
Key
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anonim
1,000 per IP
—
—
Anonim adalah tier tanpa key — tanpa domain atau key, dibatasi per IP pengunjung. Tingkatkan di konsol developer.
Widget
Sembilan widget siap pakai. Salin cuplikan, ganti dengan key Anda, daftarkan domain Anda — selesai. Segmen path (seperti slug koin) diselesaikan berdasarkan slug aset dan harus berupa pasar aktif; setiap widget juga menerima parameter query bersama di bawah.
GET
Konverter mata uang
/{locale}/embed/converter/bitcoin/usd
Konversikan jumlah antara dua aset kripto atau fiat mana pun dengan kurs pasar live, dengan tabel perbandingan opsional.