Legg Bitculators live krypto-verktøy rett inn på ditt eget nettsted med en enkelt <iframe> — et sanntids prisdiagram, en omregner, en marketcap-flipper og seks kalkulatorer. Ingen SDK, ingen byggesteg.
9 widgetsEmbed-nøkkel + domeneAnonym modus
Hver widget er en selvstendig side under /{locale}/embed/… som du legger inn på nettstedet ditt med en <iframe>. Den viser Bitculators live markedsdata — den samme strømmen appen bruker — og krever ingen JavaScript hos deg.
Lim det inn hvor som helst — ingen script-tag nødvendig:
Legg til embed-nøkkelen din som en query-parameter og registrer domenet du skal bygge inn på (begge deler i utviklerkonsollen). Nøkkelløse embeds fungerer også i anonym modus — praktisk for en rask test — men er begrenset per besøkende-IP. Hver widget respekterer {locale} i URL-en og følger theme-cookien (eller ?theme=dark).
Content-Security-Policy
Serverer du en Content-Security-Policy på nettstedet ditt? Legg til https://bitculator.com i frame-src (og child-src for eldre nettlesere) slik at widgeten kan lastes. Ingenting å endre på vår side — Bitculator tillater allerede innbygging på alle domener.
En embed-nøkkel er et token med api-tillatelsen, opprettet i utviklerkonsollen. Til forskjell fra Data API-nøkler ligger den i iframe-URL-en som en query-parameter — aldri i en header — så den er offentlig av design. Den bærer kun api-tillatelsen; de Bearer-only data-api-nøklene avvises her, så de ikke kan lekke inn i referers eller logger.
Send den som ?embed_key=… (eller aliaset ?api_key=…). En forespørsel med nøkkel må også komme fra et tillatt domene (se nedenfor). Hvis du er logget inn på Bitculator i samme nettleser, hoppes nøkkelsjekken over for din egen økt.
Domener
En embed med nøkkel vises kun på domener du har registrert. Bitculator leser den innbyggende sidens Referer (med fallback til Origin), normaliserer den (små bokstaver, www. og eventuelle etterfølgende punktum fjernet) og matcher den nøyaktig mot tillatelseslisten din. En uregistrert eller uleselig vert returnerer 403.
Administrer domener i utviklerkonsollen; hver plan tillater et fast antall (nedenfor). Fordi Referer/Origin settes av den besøkendes nettleser og kan forfalskes, er tillatelseslisten et vern mot tilfeldig gjenbruk av nøkler, ikke et kryptografisk bevis — behandle nøkkelen som offentlig uansett. Anonyme (nøkkelløse) embeds er ikke domenebegrenset; de er i stedet begrenset per IP.
Kvote og grenser
Embeds trekker fra en månedlig pool som er helt adskilt fra Data API-et — sin egen plan, sin egen teller. Anonyme innlastinger telles per besøkende-IP (1 000/måned); innlastinger med nøkkel telles mot planens månedlige grense. Free-planer nullstilles ved kalendermåneden; betalte planer nullstilles på faktureringsdagen din.
*Embed-responser bærer ingen `X-Quota--headere** — med vilje, slik at kvotetall aldri lekker inn i besøkendes sider. Følg med på forbruket ditt i [utviklerkonsollen](/user/developer/api) i stedet. (X-Quota-*`-headerne du kanskje har sett, finnes kun på Data API-et.)
Over grensen
Når en widget er over kvoten, returnerer den 429. I en nettleser-iframe er det en liten stilsatt "forbruksgrense nådd"-side (så oppsettet ditt ikke brytes); en JSON-kaller får {"message", "limit", "used"}. Legg til en nøkkel, eller oppgrader planen din, for mer.
Planer
Embed-planer er adskilt fra Data API-planen din. Hver konto starter på Free; nøkkelløse besøkende får det anonyme nivået.
Plan
Innlastinger / måned
Domener
Nøkler
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anonym
1,000 per IP
—
—
Anonym er det nøkkelløse nivået — ingen domener eller nøkler, begrenset per besøkende-IP. Oppgrader i utviklerkonsollen.
Widgets
Ni drop-in-widgets. Kopier en kodesnutt, bytt inn nøkkelen din, registrer domenet ditt — ferdig. Stisegmenter (som en coin-slug) løses opp via aktivumets slug og må være et aktivt marked; hver widget godtar også de delte query-parameterne nedenfor.
GET
Valutaomregner
/{locale}/embed/converter/bitcoin/usd
Konverter et beløp mellom hvilke som helst to krypto- eller fiat-aktiva til live markedskurser, med en valgfri sammenligningstabell.