Lägg Bitculators live-kryptoverktyg direkt på din egen sajt med en enda <iframe> — en realtidspriskurva, en omvandlare, en marketcap-flipper och sex kalkylatorer. Ingen SDK, inget byggsteg.
9 widgetarEmbed-nyckel + domänAnonymt läge
Varje widget är en fristående sida under /{locale}/embed/… som du släpper in på din sajt med en <iframe>. Den renderar Bitculators live-marknadsdata — samma flöde som appen använder — och kräver ingen JavaScript på din sida.
Klistra in den var som helst — ingen script-tagg behövs:
Lägg till din embed-nyckel som en query-parameter och registrera domänen du ska bädda in på (båda i din utvecklarkonsol). Nyckellösa embeds fungerar också i anonymt läge — praktiskt för ett snabbt test — men är begränsade per besökar-IP. Varje widget respekterar {locale} i URL:en och följer theme-cookien (eller ?theme=dark).
Content-Security-Policy
Serverar du en Content-Security-Policy på din sajt? Lägg till https://bitculator.com i din frame-src (och child-src för äldre webbläsare) så att widgeten kan laddas. Inget behöver ändras på vår sida — Bitculator tillåter redan inbäddning på valfri domän.
En embed-nyckel är en token med api-behörigheten, skapad i din utvecklarkonsol. Till skillnad från Data API-nycklar åker den med i iframe-URL:en som en query-parameter — aldrig en header — så den är offentlig till sin natur. Den bär endast api-behörigheten; de enbart Bearer-baserade data-api-nycklarna avvisas här så att de inte kan läcka in i referers eller loggar.
Skicka den som ?embed_key=… (eller aliaset ?api_key=…). En nyckelbaserad förfrågan måste också komma från en tillåtelselistad domän (se nedan). Om du är inloggad på Bitculator i samma webbläsare hoppas nyckelkontrollen över för din egen session.
Domäner
En nyckelbaserad embed renderas bara på domäner du har registrerat. Bitculator läser den inbäddande sidans Referer (faller tillbaka på Origin), normaliserar den (gemener, www. och eventuell avslutande punkt borttagen) och matchar den exakt mot din tillåtelselista. En oregistrerad eller oläsbar host returnerar 403.
Hantera domäner i din utvecklarkonsol; varje plan tillåter ett bestämt antal (nedan). Eftersom Referer/Origin sätts av besökarens webbläsare och kan förfalskas är tillåtelselistan ett skydd mot tillfällig nyckelåteranvändning, inte ett kryptografiskt bevis — behandla nyckeln som offentlig oavsett. Anonyma (nyckellösa) embeds är inte domänbegränsade; de begränsas per IP i stället.
Kvot & gränser
Embeds hämtar från en månatlig pott som är helt separat från Data API — sin egen plan, sin egen räknare. Anonyma laddningar räknas per besökar-IP (1,000/månad); nyckelbaserade laddningar räknas mot din plans månadsgräns. Free-planer nollställs vid kalendermånaden; betalplaner nollställs på din faktureringsdag.
*Embed-svar bär inga `X-Quota--headrar** — medvetet, så att kvotsiffror aldrig läcker in på dina besökares sidor. Bevaka din användning i [utvecklarkonsolen](/user/developer/api) i stället. (DeX-Quota-*`-headrar du kanske har sett finns bara på Data API.)
Över gränsen
När en widget överskrider kvoten returnerar den 429. I en webbläsar-iframe är det en liten formgiven sida med "användningsgränsen nådd" (så att din layout inte går sönder); en JSON-anropare får {"message", "limit", "used"}. Lägg till en nyckel, eller uppgradera din plan, för mer.
Planer
Embed-planer är separata från din Data API-plan. Varje konto börjar på Free; nyckellösa besökare får den anonyma nivån.
Plan
Laddningar / månad
Domäner
Nycklar
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anonym
1,000 per IP
—
—
Anonym är den nyckellösa nivån — inga domäner eller nycklar, begränsad per besökar-IP. Uppgradera i utvecklarkonsolen.
Widgetar
Nio färdiga widgetar. Kopiera en kodsnutt, byt in din nyckel, registrera din domän — klart. Sökvägssegment (som en coin-slug) matchas via tillgångens slug och måste vara en aktiv marknad; varje widget accepterar även de gemensamma query-parametrarna nedan.
GET
Valutaomvandlare
/{locale}/embed/converter/bitcoin/usd
Konvertera ett belopp mellan två valfria krypto- eller fiat-tillgångar till live-marknadskurser, med en valfri jämförelsetabell.