Sæt Bitculators live crypto-værktøjer direkte på dit eget site med en enkelt <iframe> — et prisdiagram i realtid, en konverter, en marketcap-flipper og seks beregnere. Ingen SDK, intet build-trin.
9 widgetsEmbed-nøgle + domæneAnonym tilstand
Hver widget er en selvstændig side under /{locale}/embed/…, som du dropper ind på dit site med en <iframe>. Den viser Bitculators live markedsdata — det samme feed som app'en bruger — og kræver ingen JavaScript hos dig.
Indsæt det hvor som helst — ingen script-tag nødvendig:
Tilføj din embed-nøgle som en query-parameter og registrér det domæne, du vil indlejre på (begge dele i din udviklerkonsol). Nøgleløse embeds virker også i anonym tilstand — praktisk til en hurtig test — men er begrænset pr. besøgende-IP. Hver widget respekterer {locale} i URL'en og følger theme-cookien (eller ?theme=dark).
Content-Security-Policy
Kører du en Content-Security-Policy på dit site? Tilføj https://bitculator.com til din frame-src (og child-src for ældre browsere), så widget'en kan indlæses. Intet skal ændres på vores side — Bitculator tillader allerede indlejring på ethvert domæne.
En embed-nøgle er et token med api-tilladelsen, oprettet i din udviklerkonsol. I modsætning til Data API-nøgler ligger den i iframe-URL'en som en query-parameter — aldrig en header — så den er offentlig af design. Den bærer kun api-tilladelsen; de Bearer-only data-api-nøgler afvises her, så de ikke kan lække ind i referers eller logs.
Angiv den som ?embed_key=… (eller aliasset ?api_key=…). Et request med nøgle skal desuden komme fra et domæne på tilladelseslisten (se nedenfor). Er du logget ind på Bitculator i samme browser, springes nøgletjekket over for din egen session.
Domæner
Et embed med nøgle vises kun på domæner, du har registreret. Bitculator læser den indlejrende sides Referer (med Origin som fallback), normaliserer den (små bogstaver, www. og et eventuelt afsluttende punktum fjernet) og matcher den præcist mod din tilladelsesliste. En uregistreret eller ulæselig host returnerer 403.
Administrér domæner i din udviklerkonsol; hver plan tillader et bestemt antal (nedenfor). Fordi Referer/Origin sættes af den besøgendes browser og kan forfalskes, er tilladelseslisten en beskyttelse mod tilfældig genbrug af nøgler, ikke et kryptografisk bevis — behandl nøglen som offentlig uanset hvad. Anonyme (nøgleløse) embeds er ikke domæne-begrænsede; de er i stedet begrænset pr. IP.
Kvote & grænser
Embeds trækker fra en månedlig pulje, der er helt adskilt fra Data API'et — sin egen plan, sin egen tæller. Anonyme indlæsninger tælles pr. besøgende-IP (1.000/måned); indlæsninger med nøgle tælles mod din plans månedlige grænse. Free-planer nulstilles ved kalendermåneden; betalte planer nulstilles på din faktureringsdag.
*Embed-svar bærer ingen `X-Quota-headers** — bevidst, så kvotetal aldrig lækker ind i dine besøgendes sider. Hold i stedet øje med dit forbrug i [udviklerkonsollen](/user/developer/api). (DeX-Quota-*` headers, du måske har set, findes kun på Data API'et.)
Over grænsen
Når en widget er over kvoten, returnerer den 429. I en browser-iframe er det en lille pænt formateret "forbrugsgrænse nået"-side (så dit layout ikke går i stykker); en JSON-kalder får {"message", "limit", "used"}. Tilføj en nøgle, eller opgradér din plan, for mere.
Planer
Embed-planer er adskilt fra din Data API-plan. Hver konto starter på Free; nøgleløse besøgende får det anonyme niveau.
Plan
Indlæsninger / måned
Domæner
Nøgler
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anonym
1,000 pr. IP
—
—
Anonym er det nøgleløse niveau — ingen domæner eller nøgler, begrænset pr. besøgende-IP. Opgradér i udviklerkonsollen.
Widgets
Ni drop-in-widgets. Kopiér en snippet, indsæt din nøgle, registrér dit domæne — færdig. Sti-segmenter (som en coin-slug) opløses via aktivets slug og skal være et aktivt marked; hver widget accepterer også de delte query-parametre nedenfor.
GET
Valutakonverter
/{locale}/embed/converter/bitcoin/usd
Konvertér et beløb mellem to vilkårlige crypto- eller fiat-aktiver til live markedskurser, med en valgfri sammenligningstabel.