Tuo Bitculatorin reaaliaikaiset kryptotyökalut omalle sivustollesi yhdellä <iframe>-elementillä – reaaliaikainen hintakaavio, muunnin, marketcap-flipper ja kuusi laskuria. Ei SDK-kirjastoa, ei käännösvaihetta.
9 widgetiäUpotusavain + verkkotunnusAnonyymitila
Jokainen widget on itsenäinen sivu osoitteessa /{locale}/embed/…, ja lisäät sen sivustollesi <iframe>-elementillä. Se näyttää Bitculatorin reaaliaikaista markkinadataa – samaa syötettä kuin sovellus – eikä vaadi sinulta lainkaan JavaScriptiä.
Lisää upotusavain kyselyparametriksi ja rekisteröi verkkotunnus, jolla upotat (molemmat kehittäjäkonsolissa). Upotukset toimivat myös ilman avainta anonyymitilassa – kätevää pikatestiin – mutta silloin ne on rajoitettu vierailijan IP-osoitteen mukaan. Jokainen widget noudattaa osoitteen {locale}-arvoa ja theme-evästettä (tai ?theme=dark).
Content-Security-Policy
Käytätkö sivustollasi Content-Security-Policy-otsaketta? Lisää https://bitculator.comframe-src-arvoon (ja vanhempien selainten vuoksi myös child-src-arvoon), jotta widget voi latautua. Meidän päässä ei tarvitse muuttaa mitään – Bitculator sallii upottamisen mille tahansa verkkotunnukselle.
Upotusavain on token, jolla on api-oikeus ja jonka luot kehittäjäkonsolissa. Toisin kuin Data API -avaimet, se kulkee iframen osoitteessa kyselyparametrina – ei koskaan otsakkeessa – joten se on tarkoituksella julkinen. Sillä on vain api-oikeus; pelkkään Bearer-otsakkeeseen tarkoitetut data-api-avaimet hylätään täällä, jotta ne eivät pääse vuotamaan referer-tietoihin tai lokeihin.
Anna se muodossa ?embed_key=… (tai aliaksella ?api_key=…). Avaimella tehdyn pyynnön on lisäksi tultava sallitulta verkkotunnukselta (ks. alla). Jos olet kirjautunut Bitculatoriin samassa selaimessa, avaintarkistus ohitetaan omalta istunnoltasi.
Verkkotunnukset
Avaimella varustettu upotus näkyy vain verkkotunnuksilla, jotka olet rekisteröinyt. Bitculator lukee upottavan sivun Referer-otsakkeen (tai varalta Origin), normalisoi sen (pienet kirjaimet, www. ja mahdollinen lopun piste poistetaan) ja vertaa sitä tarkasti sallittujen listaan. Rekisteröimätön tai lukukelvoton isäntänimi palauttaa 403.
Hallinnoi verkkotunnuksia kehittäjäkonsolissa; jokainen suunnitelma sallii tietyn määrän (alla). Koska Referer/Origin tulee vierailijan selaimelta ja se voidaan väärentää, sallittujen lista suojaa vain satunnaiselta avaimen uudelleenkäytöltä eikä ole kryptografinen todiste – käsittele avainta joka tapauksessa julkisena. Anonyymejä (avaimettomia) upotuksia ei rajata verkkotunnuksen vaan IP-osoitteen mukaan.
Kvootta ja rajat
Upotukset käyttävät kuukausittaista kvoottaa, joka on täysin erillinen Data API -kvootasta – oma suunnitelma, oma laskuri. Anonyymit lataukset lasketaan vierailijan IP-osoitetta kohti (1 000/kk); avaimella tehdyt lataukset vähentävät suunnitelmasi kuukausirajaa. Ilmaiset suunnitelmat nollautuvat kalenterikuukauden vaihtuessa, maksulliset laskutuspäivänäsi.
*Upotusvastaukset eivät sisällä `X-Quota--otsakkeita** – tarkoituksella, jotta kvoottaluvut eivät koskaan vuoda vierailijoidesi sivuille. Seuraa käyttöäsi sen sijaan [kehittäjäkonsolissa](/user/developer/api). (X-Quota-*`-otsakkeet, jotka olet ehkä nähnyt, ovat vain Data API -rajapinnassa.)
Rajan yli
Kun widget ylittää kvootan, se palauttaa 429. Selaimen iframessa se on pieni tyylitelty ”käyttöraja saavutettu” -sivu (jotta asettelusi ei rikkoudu); JSON-kutsuja saa vastauksen {"message", "limit", "used"}. Lisää avain tai päivitä suunnitelmaa, niin saat enemmän.
Suunnitelmat
Upotussuunnitelmat ovat erillään Data API -suunnitelmastasi. Jokainen tili aloittaa Free-tasolta; avaimettomat vierailijat saavat anonyymitason.
Suunnitelma
Latauksia / kk
Verkkotunnukset
Avaimet
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anonyymi
1,000 per IP
-
-
Anonyymi on avaimeton taso – ei verkkotunnuksia eikä avaimia, rajoitettu vierailijan IP-osoitteen mukaan. Päivitä kehittäjäkonsolissa.
Widgetit
Yhdeksän valmista widgetiä. Kopioi koodinpätkä, vaihda avaimesi tilalle, rekisteröi verkkotunnuksesi – valmis. Polun osat (kuten kolikon slug) tunnistetaan omaisuuserän slugin perusteella, ja markkinan on oltava aktiivinen; jokainen widget hyväksyy myös alla luetellut yhteiset kyselyparametrit.
GET
Valuuttamuunnin
/{locale}/embed/converter/bitcoin/usd
Muunna summa minkä tahansa kahden krypto- tai fiat-omaisuuserän välillä reaaliaikaisilla markkinakursseilla, halutessasi vertailutaulukon kanssa.