Puneți instrumentele cripto live de la Bitculator direct pe propriul site cu un singur <iframe> - un grafic de preț în timp real, un convertor, un Flipper de capitalizare de piață și șase calculatoare. Fără SDK, fără pas de compilare.
9 widget-uriCheie pentru widget-uri + domeniuMod anonim
Fiecare widget este o pagină de sine stătătoare, aflată la /{locale}/embed/…, pe care o adăugați în site-ul dumneavoastră cu un <iframe>. Afișează datele de piață live de la Bitculator - aceeași sursă pe care o folosește aplicația - și nu are nevoie de JavaScript de partea dumneavoastră.
Lipiți-l oriunde - nu este nevoie de nicio etichetă script:
Adăugați cheia pentru widget-uri ca parametru de interogare și înregistrați domeniul pe care veți face încorporarea (ambele în consola pentru dezvoltatori). Widget-urile fără cheie funcționează și ele, în mod anonim - util pentru un test rapid - dar sunt limitate per adresă IP de vizitator. Fiecare widget respectă {locale} din URL și urmează cookie-ul theme (sau ?theme=dark).
Content-Security-Policy
Site-ul dumneavoastră trimite un antet Content-Security-Policy? Adăugați https://bitculator.com în frame-src (și în child-src, pentru browserele mai vechi), ca widgetul să se poată încărca. De partea noastră nu trebuie schimbat nimic - Bitculator permite deja încorporarea pe orice domeniu.
Alegeți un widget și opțiunile sale - fragmentul de cod pentru încorporare se actualizează pe măsură ce lucrați. Copiați-l sau deschideți o previzualizare live într-o filă nouă.
O cheie pentru widget-uri este un token cu permisiunea api, emis în consola pentru dezvoltatori. Spre deosebire de cheile pentru API-ul de date, aceasta călătorește în URL-ul iframe-ului, ca parametru de interogare - niciodată într-un antet - așa că este publică prin concepție. Poartă doar permisiunea api; cheile data-api, care funcționează exclusiv ca Bearer, sunt respinse aici, ca să nu poată ajunge în anteturile Referer sau în jurnale.
Transmiteți-o ca ?embed_key=… (sau prin aliasul ?api_key=…). O cerere cu cheie trebuie să vină și de pe un domeniu aflat pe lista celor permise (vedeți mai jos). Dacă sunteți autentificat în Bitculator în același browser, verificarea cheii este omisă pentru propria dumneavoastră sesiune.
Domenii
Un widget cu cheie se afișează doar pe domeniile pe care le-ați înregistrat. Bitculator citește antetul Referer al paginii care face încorporarea (cu revenire la Origin), îl normalizează (trecut la litere mici, fără www. și fără eventualul punct final) și îl compară exact cu lista dumneavoastră de domenii permise. Un host neînregistrat sau care nu poate fi citit returnează 403.
Gestionați domeniile în consola pentru dezvoltatori; fiecare abonament permite un anumit număr (mai jos). Pentru că Referer/Origin este stabilit de browserul vizitatorului și poate fi falsificat, lista de domenii permise este o protecție împotriva reutilizării ocazionale a cheii, nu o dovadă criptografică - tratați cheia ca publică în orice caz. Widget-urile anonime (fără cheie) nu sunt restricționate pe domeniu; în schimb, sunt limitate per adresă IP.
Cotă și limite
Widget-urile consumă dintr-o alocație lunară complet separată de API-ul de date - cu propriul abonament și propriul contor. Încărcările anonime se contorizează per adresă IP de vizitator (1.000/lună); încărcările cu cheie se scad din limita lunară a abonamentului dumneavoastră. Abonamentele gratuite se resetează la luna calendaristică; abonamentele plătite se resetează în ziua dumneavoastră de facturare.
*Răspunsurile widget-urilor nu conțin anteturi `X-Quota-** - în mod deliberat, pentru ca cifrele de cotă să nu ajungă niciodată în paginile vizitatorilor dumneavoastră. Urmăriți-vă consumul în [consola pentru dezvoltatori](/user/developer/api). (AnteturileX-Quota-*` pe care poate le-ați văzut există doar la API-ul de date.)
Peste limită
Când un widget depășește cota, returnează 429. Într-un iframe de browser, aceasta este o pagină mică, stilizată, cu mesajul "limită de utilizare atinsă" (ca să nu se strice aranjamentul paginii dumneavoastră); un apelant JSON primește {"message", "limit", "used"}. Adăugați o cheie sau faceți upgrade la abonament pentru mai mult.
Abonamente
Abonamentele pentru widget-uri sunt separate de abonamentul dumneavoastră pentru API-ul de date. Fiecare cont începe cu Gratuit; vizitatorii fără cheie primesc treapta anonimă.
Abonament
Încărcări / lună
Domenii
Chei
Gratuit
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anonim
1,000 per IP
-
-
Anonim este treapta fără cheie - fără domenii și fără chei, limitată per adresă IP de vizitator. Faceți upgrade în consola pentru dezvoltatori.
Widget-uri
Nouă widget-uri gata de folosit. Copiați un fragment de cod, puneți-vă cheia, înregistrați-vă domeniul - gata. Segmentele de cale (precum slugul unei monede) se rezolvă după slugul activului și trebuie să corespundă unei piețe active; fiecare widget acceptă și parametrii de interogare comuni de mai jos.
GET
Convertor valutar
/{locale}/embed/converter/bitcoin/usd
Convertiți o sumă între oricare două active cripto sau fiat la cursuri de piață live, cu un tabel de comparație opțional.