Bitculator · Beágyazások · v1

Beágyazható widgetek

Tedd ki a Bitculator élő kripto segédeszközeit közvetlenül a saját oldaladra egyetlen <iframe> segítségével - valós idejű árfolyamgrafikon, valutaváltó, piaci kapitalizáció-váltó és hat kalkulátor. Nincs SDK, nincs build lépés.

9 widget Beágyazási kulcs + domain Anonim mód

Minden widget egy önálló oldal a /{locale}/embed/… útvonalon, amelyet egy <iframe> segítségével illeszthetsz be az oldaladra. A Bitculator élő piaci adatait jeleníti meg - ugyanazt az adatfolyamot, amit az alkalmazás használ -, és nem igényel JavaScriptet a te oldaladon.

Illeszd be bárhová - script tag nem kell:

<iframe src="https://bitculator.com/hu/embed/converter/bitcoin/usd?embed_key=YOUR_EMBED_KEY"
        title="Bitculator converter" loading="lazy"
        width="100%" height="470" style="border:0;border-radius:12px"></iframe>

Add meg a beágyazási kulcsot query paraméterként, és regisztráld azt a domaint, amelyre beágyazod (mindkettőt a fejlesztői konzolban). A kulcs nélküli beágyazások is működnek anonim módban - jó egy gyors teszthez -, de látogatói IP-nként korlátozottak. Minden widget figyelembe veszi az URL-ben lévő {locale} értéket, és követi a theme cookie-t (vagy a ?theme=dark paramétert).

Content-Security-Policy

Content-Security-Policy fejlécet használsz az oldaladon? Vedd fel a https://bitculator.com címet a frame-src (régebbi böngészőknél a child-src) direktívába, hogy a widget be tudjon töltődni. A mi oldalunkon nincs mit állítani - a Bitculator eleve engedélyezi a beágyazást bármilyen domainen.

Content-Security-Policy: frame-src https://bitculator.com

Kódrészlet-építő

Válassz egy widgetet és a beállításait - a beágyazási kódrészlet menet közben frissül. Másold ki, vagy nyisd meg az élő előnézetet új lapon.

Widget

compact

Téma Beágyazási kulcs

Beágyazási kódrészlet Példa megnyitása

Élőben, anonim módban jelenik meg.

Hitelesítés

A beágyazási kulcs egy api jogosultsággal rendelkező token, amelyet a fejlesztői konzolban hozhatsz létre. A Data API kulcsokkal ellentétben ez az iframe URL-jében, query paraméterként utazik - soha nem fejlécben -, így eleve nyilvános. Kizárólag az api jogosultságot hordozza; a csak Bearer-rel használható data-api kulcsokat itt elutasítjuk, hogy ne szivárogjanak referer-fejlécekbe vagy naplókba.

Add meg ?embed_key=… formában (vagy az ?api_key=… aliasként). A kulcsos kérésnek engedélyezett domainről is kell érkeznie (lásd lent). Ha ugyanabban a böngészőben be vagy jelentkezve a Bitculatorba, a saját munkameneted esetén kimarad a kulcsellenőrzés.

Domainek

A kulcsos beágyazás csak az általad regisztrált domaineken jelenik meg. A Bitculator kiolvassa a beágyazó oldal Referer fejlécét (ennek hiányában az Origin-t), normalizálja (kisbetűsítés, a www. előtag és a záró pont eltávolítása), majd pontosan összeveti az engedélyezési listával. A nem regisztrált vagy nem olvasható hoszt válasza 403.

A domaineket a fejlesztői konzolban kezelheted; minden csomag adott számot engedélyez (lásd lent). Mivel a Referer/Origin fejlécet a látogató böngészője állítja be, és hamisítható, az engedélyezési lista a kulcs alkalmi újrahasznosítása ellen véd, nem kriptográfiai bizonyíték - a kulcsot mindenképp nyilvánosként kezeld. Az anonim (kulcs nélküli) beágyazásoknál nincs domainszűrés; helyette IP-nként érvényes korlát van.

Kvóta és korlátok

A beágyazások a Data API-tól teljesen elkülönülő havi készletből fogyasztanak - saját csomag, saját számláló. Az anonim betöltések látogatói IP-nként számítanak (havi 1 000); a kulcsos betöltések a csomagod havi korlátjába számítanak bele. Az ingyenes csomagok a naptári hónap fordulóján nullázódnak, a fizetős csomagok a számlázási napodon.

*A beágyazási válaszok nem tartalmaznak `X-Quota-fejléceket** - szándékosan, hogy a kvótaszámok soha ne szivárogjanak a látogatóid oldalaira. A felhasználást inkább a [fejlesztői konzolban](/user/developer/api) kövesd. (AzX-Quota-*` fejlécek, amelyeket esetleg láttál, csak a Data API-n vannak.)

Korláton túl

Ha egy widget túllépi a kvótát, 429 a válasz. Böngészőbeli iframe-ben ez egy kis, formázott „elérted a felhasználási korlátot” oldal (hogy ne csússzon szét az elrendezésed); JSON-hívó esetén {"message", "limit", "used"} érkezik. Többért adj meg kulcsot, vagy válts nagyobb csomagra.

Csomagok

A beágyazási csomagok elkülönülnek a Data API csomagodtól. Minden fiók a Free csomaggal indul; a kulcs nélküli látogatók az anonim szintet kapják.

Csomag	Betöltés / hónap	Domainek	Kulcsok
Free	10,000	1	2
Starter	50,000	3	5
Pro	500,000	10	10
Anonim	1,000 IP-nként	-	-

Az Anonim a kulcs nélküli szint - nincs domain és nincs kulcs, a korlát látogatói IP-nként érvényes. Váltás nagyobb csomagra a fejlesztői konzolban.

Widgetek

Kilenc beilleszthető widget. Másold ki a kódrészletet, cseréld be a kulcsodat, regisztráld a domainedet - kész. Az útvonalszegmensek (például egy érme slugja) az eszköz slugja alapján oldódnak fel, és aktív piacnak kell lenniük; minden widget elfogadja az alábbi közös query paramétereket is.

GET

Valutaváltó

/{locale}/embed/converter/bitcoin/usd

Váltsd át egy összeget bármely két kripto- vagy fiat eszköz között élő piaci árfolyamon, opcionális összehasonlító táblázattal.

Beágyazási kódrészlet Példa megnyitása

<iframe src="https://bitculator.com/hu/embed/converter/bitcoin/usd?embed_key=YOUR_EMBED_KEY"
        title="Bitculator converter" loading="lazy"
        width="100%" height="470" style="border:0;border-radius:12px"></iframe>

Paraméter	Helye	Alapérték
fromAz eszköz, amelyből átváltunk, slug alapján (aktív piac).	útvonal	-
toAz eszköz, amelyre átváltunk, slug alapján (aktív piac).	útvonal	-
hideTableElrejti az összehasonlító táblázatot, és csak a valutaváltót mutatja.	query	false
compactTömörebb elrendezés szűkebb térközökkel - keskeny oszlopokhoz jó.	query	false

Élő előnézet

GET

Árfolyamtörténeti grafikon

/{locale}/embed/zoom/bitcoin

Egy érme teljes árfolyamtörténete interaktív grafikonon, a piaci kapitalizáció szerinti vezető piacok választójával.

Beágyazási kódrészlet Példa megnyitása

<iframe src="https://bitculator.com/hu/embed/zoom/bitcoin?embed_key=YOUR_EMBED_KEY"
        title="Bitculator price chart" loading="lazy"
        width="100%" height="460" style="border:0;border-radius:12px"></iframe>

Paraméter	Helye	Alapérték
slugA grafikonon megjelenítendő érme vagy token, slug alapján (aktív piac).	útvonal	-
compactTömörebb elrendezés szűkebb térközökkel - keskeny oszlopokhoz jó.	query	false

Élő előnézet

GET

Piaci kapitalizáció-váltó

/{locale}/embed/flip/bitcoin/ethereum

A „flippening” - mennyi lenne az egyik eszköz árfolyama egy másik piaci kapitalizációja mellett, a hozzá tartozó többszörözővel.

Beágyazási kódrészlet Példa megnyitása

<iframe src="https://bitculator.com/hu/embed/flip/bitcoin/ethereum?embed_key=YOUR_EMBED_KEY"
        title="Bitculator marketcap flipper" loading="lazy"
        width="100%" height="460" style="border:0;border-radius:12px"></iframe>

Paraméter	Helye	Alapérték
entity1Az eszköz, amelynek az árfolyamát újraszámoljuk, slug alapján (aktív piac).	útvonal	-
entity2Az eszköz, amelynek a piaci kapitalizációját alkalmazzuk, slug alapján (aktív piac).	útvonal	-
compactTömörebb elrendezés szűkebb térközökkel - keskeny oszlopokhoz jó.	query	false

Élő előnézet

GET

DCA-szimulátor

/{locale}/embed/dca

Mennyit gyűjtött volna össze és mennyit hozott volna egy érme heti rendszeres vásárlása az elmúlt 5 évben.

Beágyazási kódrészlet Példa megnyitása

<iframe src="https://bitculator.com/hu/embed/dca?embed_key=YOUR_EMBED_KEY"
        title="Bitculator DCA simulator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

Paraméter	Helye	Alapérték
compactTömörebb elrendezés szűkebb térközökkel - keskeny oszlopokhoz jó.	query	false

Élő előnézet

GET

Profitkalkulátor

/{locale}/embed/profit

Nettó profit, veszteség és ROI vételi árból, eladási árból, mennyiségből és díjakból.

Beágyazási kódrészlet Példa megnyitása

<iframe src="https://bitculator.com/hu/embed/profit?embed_key=YOUR_EMBED_KEY"
        title="Bitculator profit calculator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

Paraméter	Helye	Alapérték
compactTömörebb elrendezés szűkebb térközökkel - keskeny oszlopokhoz jó.	query	false

Élő előnézet

GET

Kamatkalkulátor

/{locale}/embed/interest

Egy állomány jövőbeli értékének becslése kezdőtőkéből, kamatlábból és kamatozási gyakoriságból.

Beágyazási kódrészlet Példa megnyitása

<iframe src="https://bitculator.com/hu/embed/interest?embed_key=YOUR_EMBED_KEY"
        title="Bitculator interest calculator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

Paraméter	Helye	Alapérték
compactTömörebb elrendezés szűkebb térközökkel - keskeny oszlopokhoz jó.	query	false

Élő előnézet

GET

Adókalkulátor

/{locale}/embed/tax

Becsüld meg az adóalapot és a fizetendő adót kereskedési nyereségre, bányászatra, stakelésre, airdropokra és hozamra.

Beágyazási kódrészlet Példa megnyitása

<iframe src="https://bitculator.com/hu/embed/tax?embed_key=YOUR_EMBED_KEY"
        title="Bitculator tax calculator" loading="lazy"
        width="100%" height="580" style="border:0;border-radius:12px"></iframe>

Paraméter	Helye	Alapérték
compactTömörebb elrendezés szűkebb térközökkel - keskeny oszlopokhoz jó.	query	false

Élő előnézet

GET

Hitelkalkulátor

/{locale}/embed/loan

Modellezz egy kriptohitelt - törlesztés, teljes kamat és amortizációs lebontás.

Beágyazási kódrészlet Példa megnyitása

<iframe src="https://bitculator.com/hu/embed/loan?embed_key=YOUR_EMBED_KEY"
        title="Bitculator loan calculator" loading="lazy"
        width="100%" height="580" style="border:0;border-radius:12px"></iframe>

Paraméter	Helye	Alapérték
compactTömörebb elrendezés szűkebb térközökkel - keskeny oszlopokhoz jó.	query	false

Élő előnézet

GET

Stakelés-kalkulátor

/{locale}/embed/staking

Becsüld meg a stakelési jutalmakat a stakelt összeg, az APR/APY és az időtartam alapján.

Beágyazási kódrészlet Példa megnyitása

<iframe src="https://bitculator.com/hu/embed/staking?embed_key=YOUR_EMBED_KEY"
        title="Bitculator staking calculator" loading="lazy"
        width="100%" height="520" style="border:0;border-radius:12px"></iframe>

Paraméter	Helye	Alapérték
compactTömörebb elrendezés szűkebb térközökkel - keskeny oszlopokhoz jó.	query	false

Élő előnézet