Bitculator

Zásady

Zásady embed widgetů

Jak fungují klíče, domény a limity, co zůstává v rámci verze stabilní a co se zaznamenává, když se widget načte na vašem webu.

Klíče

Embed klíče se vytvářejí v embed konzoli po přihlášení s ověřenou e-mailovou adresou; účty vytvořené přes kryptopeněženku jsou výjimkou. Free, Starter a Pro povolují 2, 5 a 10 klíčů. Klíč se zobrazí jednou, nevyprší a jeho zneplatnění platí od dalšího načtení. Předávejte ho jako ?embed_key= (?api_key= funguje dál); klíče Data API a MCP jsou odmítnuty s 403.

Domény

Každé načtení s klíčem se kontroluje proti doménám registrovaným ve vašem účtu, které se čtou z hlavičky Referer (nebo Origin) embedující stránky. Host se převede na malá písmena a schéma, cesta, port, koncová tečka a úvodní www. se zahodí; jakákoli jiná subdoména potřebuje vlastní záznam. Free, Starter a Pro povolují 1, 3 a 10 domén.

Načtení bez refereru nebo z neregistrované domény je odmítnuto s 403 - ponechte na svém iframu výchozí referrer policy prohlížeče. Doména, kterou přidáte, funguje okamžitě; odebrání může trvat až 5 minut.

Limity

Každé načtení stránky s widgetem se počítá jako jeden požadavek, včetně automatizovaných návštěvníků: Free povoluje 10 000 měsíčně, Starter 50 000 a Pro 500 000. Na Free je měsícem kalendářní měsíc v UTC, na placených plánech se počítá od vašeho fakturačního dne. Widgety fungují i bez klíče, až do 1 000 načtení měsíčně na návštěvníka napříč všemi widgety bez klíče na všech webech.

Po překročení limitu widget až do dalšího období místo nástroje zobrazí stránku s limitem využití (HTTP 429); žádné poplatky za překročení se neúčtují. Přechody na vyšší plán platí okamžitě, přechody na nižší plán a zrušení na konci zaplaceného období, a klíče a domény nad příděl nižšího plánu fungují dál, jen nemůžete přidávat další.

Na co se můžete spolehnout

Kontrakt tvoří URL widgetů pod /{locale}/embed/ v kterémkoli z 27 jazyků, jejich query parametry - embed_key, compact, theme=dark a u widgetů se sekcemi layout a visible - a zprávy o výšce bitculator-embed-resize. Když se změní slug coinu, jeho stará URL widgetu přesměruje a zachová vaše parametry.

Údaje odpovídají okamžiku načtení stránky a neaktualizují se živě: ceny coinů se přepočítávají každou minutu a fiat kurzy dvakrát denně. Widgety může do rámce vložit jakýkoli web a vyhledávače je neindexují.

Co se počítá jako nekompatibilní změna

Tohle se v rámci jedné verze nikdy nestane:

  • Odstranění widgetu, query parametru nebo sekce, kterou mohou jmenovat layout a visible.
  • Změna toho, co dělá existující parametr.
  • Snížení počtu načtení, domén nebo klíčů, které plán už má.

Tohle se může stát kdykoli a zaznamenává se to v changelogu:

  • Nové widgety, parametry, sekce a jazyky.
  • Změny designu uvnitř widgetu a opravy výpočtů.
  • Vyšší limity.

Ukončování podpory

Odstranění verze widgetu nebo snížení limitu se oznamuje v changelogu a e-mailem každému majiteli klíče nejméně šest měsíců předem, jak stanovují podmínky služby.

Aktuálně nic není zastaralé ani naplánované k odstranění.

Uvedení zdroje

Každý widget nese na každém plánu odkaz „Powered by Bitculator“ na odpovídající nástroj na bitculator.com. Musí zůstat viditelný a nezměněný.

Data a soukromí

U každého načtení s klíčem počítáme účet, klíč, embedující doménu, widget a fakturační období plus denní součet a tyto počty uchováváme 12 měsíců. Načtení bez klíče se počítají podle domény a widgetu bez IP návštěvníka; limit na návštěvníka používá klíčovaný hash IP adresy, který se na konci měsíce zahodí.

Widgety nenastavují žádné cookies a neregistrují žádný service worker. Ukládají vlastní uspořádání sekcí návštěvníka v jeho prohlížeči a odesílají vlastní analytiku Bitculatoru - zobrazení stránky a měření rychlosti stránky - identifikovanou pouze hashem, který se denně mění, a uchovávanou nejvýše 95 dní.

Odpovědné hlášení zranitelností

Pokud se domníváte, že jste našli bezpečnostní zranitelnost na bitculator.com, v Data API, MCP serveru nebo SDK, napište na contact@bitculator.com a uveďte dotčenou URL nebo endpoint, kroky k reprodukci a dopad, který pozorujete. Odpověď dostanete do tří pracovních dnů.

Prosíme, držte hlášení v tajnosti, dokud není problém opraven, nepřistupujte k datům, která nejsou vaše, ani je neupravujte a nespouštějte proti produkci denial-of-service ani automatizované skenování. Hlášení podaná v dobré víře za těchto podmínek nebudou stíhána právní cestou. Placený bounty program neexistuje; na požádání uvedeme vaše jméno.

Stejný kontakt je strojově čitelně publikován na /.well-known/security.txt (RFC 9116).

Stav a incidenty

Živý stav komponent, otevřené incidenty a výpadky za posledních 30 dní najdete na stavové stránce a na /status.json.