Umiestnite živé krypto nástroje platformy Bitculator priamo na vašu vlastnú stránku jediným <iframe> – graf cien v reálnom čase, prevodník, Flip trhovej kapitalizácie a šesť kalkulačiek. Žiadne SDK, žiadne zostavovanie.
9 widgetovKľúč vloženia + doménaAnonymný režim
Každý widget je samostatná stránka na adrese /{locale}/embed/…, ktorú do svojej stránky vložíte cez <iframe>. Vykresľuje živé trhové dáta platformy Bitculator – rovnaký zdroj, aký používa samotná aplikácia – a na vašej strane nevyžaduje žiadny JavaScript.
Vložte ho kamkoľvek – nie je potrebná žiadna značka script:
Pridajte svoj kľúč vloženia ako parameter dotazu a zaregistrujte doménu, na ktorej budete vkladať (oboje vo vašej vývojárskej konzole). Vloženia bez kľúča fungujú aj v anonymnom režime – hodí sa to na rýchly test – ale sú obmedzené podľa IP adresy návštevníka. Každý widget rešpektuje {locale} v URL adrese a riadi sa cookie theme (alebo ?theme=dark).
Content-Security-Policy
Používate na svojej stránke Content-Security-Policy? Pridajte https://bitculator.com do frame-src (a do child-src pre staršie prehliadače), aby sa widget načítal. Na našej strane sa nemusí meniť nič – Bitculator už vkladanie na ľubovoľnej doméne povoľuje.
Kľúč vloženia je token s oprávnením api, vytvorený vo vašej vývojárskej konzole. Na rozdiel od kľúčov k Data API cestuje v URL adrese iframe ako parameter dotazu – nikdy nie v hlavičke – takže je zámerne verejný. Nesie iba oprávnenie api; kľúče data-api, ktoré sa posielajú výhradne cez Bearer, sú tu odmietnuté, aby nemohli uniknúť do referrerov ani do logov.
Odovzdajte ho ako ?embed_key=… (alebo cez alias ?api_key=…). Požiadavka s kľúčom musí zároveň prichádzať z domény na zozname povolených (pozri nižšie). Ak ste v rovnakom prehliadači prihlásení do Bitculatora, kontrola kľúča sa pre vašu vlastnú reláciu preskočí.
Domény
Vloženie s kľúčom sa vykreslí iba na doménach, ktoré ste zaregistrovali. Bitculator prečíta hlavičku Referer vkladajúcej stránky (záložne Origin), normalizuje ju (malé písmená, odstránené www. aj prípadná koncová bodka) a porovná ju presne s vaším zoznamom povolených domén. Nezaregistrovaný alebo nečitateľný hostiteľ vráti 403.
Domény spravujete vo svojej vývojárskej konzole; každý plán ich povoľuje určitý počet (nižšie). Keďže Referer/Origin nastavuje prehliadač návštevníka a dá sa podvrhnúť, zoznam povolených domén je ochranou proti bežnému zneužitiu kľúča, nie kryptografickým dôkazom – kľúč tak či tak považujte za verejný. Anonymné vloženia (bez kľúča) nie sú viazané na doménu; namiesto toho sú obmedzené podľa IP adresy.
Kvóta a limity
Widgety čerpajú z mesačného fondu, ktorý je úplne oddelený od Data API – s vlastným plánom aj vlastným počítadlom. Anonymné načítania sa počítajú podľa IP adresy návštevníka (1 000 mesačne); načítania s kľúčom sa počítajú do mesačného limitu vášho plánu. Bezplatné plány sa resetujú s kalendárnym mesiacom; platené plány sa resetujú vo váš fakturačný deň.
*Odpovede widgetov neobsahujú žiadne hlavičky `X-Quota-** – zámerne, aby čísla o kvóte nikdy neunikli na stránky vašich návštevníkov. Svoje využitie namiesto toho sledujte vo [vývojárskej konzole](/user/developer/api). (HlavičkyX-Quota-*`, ktoré ste možno videli, existujú iba pri Data API.)
Nad limitom
Keď je widget nad kvótou, vráti 429. V prehliadačovom iframe je to malá naštýlovaná stránka „dosiahnutý limit využitia“ (aby sa vám nerozbilo rozloženie); volajúci cez JSON dostane {"message", "limit", "used"}. Ak potrebujete viac, pridajte kľúč alebo prejdite na vyšší plán.
Plány
Plány pre widgety sú oddelené od vášho plánu Data API. Každý účet začína na pláne Zadarmo; návštevníci bez kľúča dostanú anonymnú úroveň.
Plán
Načítania / mesiac
Domény
Kľúče
Zadarmo
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anonymný
1,000 na IP
-
-
Anonymný je úroveň bez kľúča – žiadne domény ani kľúče, obmedzenie podľa IP adresy návštevníka. Na vyšší plán prejdete vo vývojárskej konzole.
Widgety
Deväť hotových widgetov. Skopírujte kód, doplňte svoj kľúč, zaregistrujte doménu – hotovo. Segmenty cesty (napríklad slug kryptomeny) sa vyhodnocujú podľa slugu aktíva a musia zodpovedať aktívnemu trhu; každý widget prijíma aj spoločné parametre dotazu uvedené nižšie.
GET
Prevodník mien
/{locale}/embed/converter/bitcoin/usd
Preveďte sumu medzi ľubovoľnými dvoma krypto alebo fiat aktívami podľa živých trhových kurzov, s voliteľnou porovnávacou tabuľkou.