Bitculator'ın canlı kripto araçlarını tek bir <iframe> ile doğrudan kendi sitenize ekleyin — gerçek zamanlı bir fiyat grafiği, bir dönüştürücü, bir marketcap çevirici ve altı hesaplayıcı. SDK yok, derleme adımı yok.
9 widgetEmbed anahtarı + alan adıAnonim mod
Her widget, /{locale}/embed/… altında, sitenize bir <iframe> ile eklediğiniz bağımsız bir sayfadır. Bitculator'ın canlı piyasa verilerini — uygulamanın kullandığı akışın aynısını — işler ve sizin tarafınızda hiç JavaScript gerektirmez.
İstediğiniz yere yapıştırın — script etiketi gerekmez:
Embed anahtarınızı bir sorgu parametresi olarak ekleyin ve embed edeceğiniz alan adını kaydedin (ikisi de geliştirici konsolunuzda). Anahtarsız embed'ler anonim modda da çalışır — hızlı bir test için kullanışlıdır — ancak ziyaretçi IP'si başına sınırlıdır. Her widget URL'deki {locale} değerine uyar ve theme çerezini (veya ?theme=dark) izler.
Content-Security-Policy
Sitenizde bir Content-Security-Policy mi sunuyorsunuz? Widget'ın yüklenebilmesi için frame-src (ve eski tarayıcılar için child-src) yönergenize https://bitculator.com adresini ekleyin. Bizim tarafımızda değiştirilecek hiçbir şey yok — Bitculator her alan adında embed edilmeye zaten izin veriyor.
Bir embed anahtarı, geliştirici konsolunuzda oluşturulan, api yetkisine sahip bir token'dır. Data API anahtarlarının aksine, iframe URL'sinde bir sorgu parametresi olarak taşınır — asla bir başlıkta değil — bu yüzden tasarımı gereği herkese açıktır. Yalnızca api yetkisini taşır; yalnızca Bearer olan data-api anahtarları, referer'lara veya günlüklere sızmamaları için burada reddedilir.
Bunu ?embed_key=… (veya takma adı ?api_key=…) olarak geçirin. Anahtarlı bir istek ayrıca izin listesindeki bir alan adından gelmelidir (aşağıya bakın). Aynı tarayıcıda Bitculator'a giriş yapmışsanız, kendi oturumunuz için anahtar kontrolü atlanır.
Alan adları
Anahtarlı bir embed yalnızca kaydettiğiniz alan adlarında görüntülenir. Bitculator, embed eden sayfanın Referer değerini okur (Origin'e geri döner), normalleştirir (küçük harfe çevrilir, www. ve varsa sondaki nokta kaldırılır) ve izin listenizle tam olarak eşleştirir. Kayıtlı olmayan veya okunamayan bir sunucu 403 döndürür.
Alan adlarını geliştirici konsolunuzda yönetin; her plan belirli bir sayıya izin verir (aşağıda). Referer/Origin ziyaretçinin tarayıcısı tarafından ayarlandığı ve taklit edilebileceği için, izin listesi kriptografik bir kanıt değil, rastgele anahtar yeniden kullanımına karşı bir korumadır — anahtarı her durumda herkese açık kabul edin. Anonim (anahtarsız) embed'ler alan adıyla kısıtlanmaz; bunun yerine IP başına sınırlıdır.
Kota ve limitler
Embed'ler Data API'den tamamen ayrı olan aylık bir havuzdan çekilir — kendi planı, kendi sayacı. Anonim yüklemeler ziyaretçi IP'si başına sayılır (1,000/ay); anahtarlı yüklemeler planınızın aylık limitine sayılır. Free planlar takvim ayında sıfırlanır; ücretli planlar faturalandırma gününüzde sıfırlanır.
*Embed yanıtları `X-Quota-başlıkları taşımaz** — bu bilinçli bir tercihtir, böylece kota sayıları asla ziyaretçilerinizin sayfalarına sızmaz. Bunun yerine kullanımınızı [geliştirici konsolunda](/user/developer/api) izleyin. (Görmüş olabileceğinizX-Quota-*` başlıkları yalnızca Data API'dedir.)
Limitin üzerinde
Bir widget kotayı aştığında 429 döndürür. Bir tarayıcı iframe'inde bu, küçük ve şık bir "kullanım limitine ulaşıldı" sayfasıdır (böylece düzeniniz bozulmaz); bir JSON çağırıcısı {"message", "limit", "used"} alır. Daha fazlası için bir anahtar ekleyin veya planınızı yükseltin.
Planlar
Embed planları Data API planınızdan ayrıdır. Her hesap Free ile başlar; anahtarsız ziyaretçiler anonim katmanı alır.
Plan
Yükleme / ay
Alan adları
Anahtarlar
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anonim
1,000 IP başına
—
—
Anonim, anahtarsız katmandır — alan adı veya anahtar yok, ziyaretçi IP'si başına sınırlı. Geliştirici konsolundan yükseltin.
Widget'lar
Dokuz hazır widget. Bir kod parçacığını kopyalayın, anahtarınızı ekleyin, alan adınızı kaydedin — tamam. Yol segmentleri (bir koin slug'ı gibi) varlığın slug'ına göre çözümlenir ve aktif bir piyasa olmalıdır; her widget aşağıdaki paylaşılan sorgu parametrelerini de kabul eder.
GET
Para birimi dönüştürücü
/{locale}/embed/converter/bitcoin/usd
Bir miktarı, herhangi iki kripto veya fiat varlık arasında canlı piyasa kurlarında, isteğe bağlı bir karşılaştırma tablosuyla dönüştürün.