Változásnapló
A beágyazható widgetek minden változása – URL-ek, paraméterek, kulcsok, domainek és korlátok –, a legújabbal kezdve. Azt, hogy mi marad stabil egy verzión belül, a szabályzatok rögzítik.
A widgetek már nem nyitnak websocket-kapcsolatot a Bitculator felé, és nem írnak fordítási adatokat a látogató böngészőjének tárolójába. A képernyőn semmi sem változik: a widgetek soha nem közvetítettek élő árakat, így a számok mindig az oldal betöltésekori állapotot mutatják.
A tőkésítési időszak közben véget érő futamidő mostantól időarányos kamatot hoz, és az időszakon belül teljesített befizetések is jóváíródnak, a növekedési görbe pontjai pedig az eltelt idő szerint helyezkednek el. A bemenetek felső korlátja: 1 000 000 000 000 tőke, 1 000 000 000 befizetés, 1 000% kamatláb és 50 év vagy 600 hónap; a korlátot meghaladó értéket a korlátra állítjuk vissza.
A kamatláb mostantól éves névleges kamatláb, amely eloszlik a tőkésítési időszakok között. Korábban a teljes kamatlábat minden időszakra alkalmaztuk, így a havi tőkésítésű 5% havi 5%-ként nőtt; a meglévő beágyazások eredményei ennek megfelelően csökkennek.
Egy fizetős beágyazási csomag lemondása mostantól az esetleg ütemezett visszaminősítést is törli; a csomag egyszerűen a kifizetett időszak végéig fut.
A DCA kezdő- és záródátum-választója a dátumokat UTC szerinti éjfélként olvasta, így az UTC-től nyugatra lévő látogatóknak az előző napot mutatta. Mostantól a látogató helyi naptári napját használják.
A {locale} útvonalszegmens mostantól ezeket is elfogadja: ar (jobbról balra megjelenítve), sk, th, ko, ro, hu, sr és fi; ezek szeptember 19. és 24. között kerültek be, így összesen 27 nyelv érhető el.
A widgetoldalak már nem állítanak be munkamenet- vagy XSRF-sütit, és nem regisztrálnak service workert a látogató böngészőjében. A kulcs nélküli, látogatónkénti számláló mostantól az IP-cím kulcsolt hash-ét használja, a hivatkozó nélküli, kulcs nélküli betöltéseket pedig IP-cím helyett „direct” néven jelentjük.
A /embed/zoom/{slug} havi és heti sorait mostantól munkamenet-token nélkül kérjük le – ilyen tokent egy másik oldal iframe-jében futó widget nem kaphat meg.
A valutaváltó nem mutat számot, ha valamelyik eszköznek nincs használható ára, „1 X = 0 Y” helyett, a piaci kapitalizáció-váltó pedig törli a számait, ha egy párnak nincs piaci kapitalizációja, ahelyett hogy az előző pár számait mutatná az új nevek alatt.
Az érme korábbi slugját használó widget-URL mostantól 301 átirányítással ugyanarra a widgetre mutat az aktuális slug alatt, a query stringet – az embed_key paramétert is beleértve – megtartva. Korábban 404 választ adott.
A regisztrált domaineket úgy dolgozzuk fel, ahogy a böngésző egy URL-t olvas: a séma, az útvonal, a port és a kezdő www. lekerül, a név kisbetűssé válik, a nemzetközi nevek pedig punycode formára alakulnak; ami nem hosztnév, azt elutasítjuk. A beágyazó oldal Referer fejlécét ugyanígy normalizáljuk. A www kivételével minden aldomainnek továbbra is saját bejegyzés kell.
Az alacsonyabb beágyazási csomagra váltás mostantól a kifizetett időszak végén lép életbe. Korábban az azonos számlázási ciklusú visszaminősítés azonnal érvénybe lépett, és időszak közben csökkentette a havi korlátot. A bővítések továbbra is azonnal érvényesek.
Az ismeretlen vagy inaktív érme-slug mostantól puszta „Not Found” szöveges választ ad, ahelyett hogy a teljes Bitculator-oldalt – fejléccel, oldalsávval és lábléccel – megjelenítené az iframe-edben.
Beágyazási kulcs létrehozásához mostantól megerősített e-mail-cím szükséges; a kriptotárcával létrehozott fiókok mentesülnek ez alól. Percenként legfeljebb 10 kulcs hozható létre, a meglévő kulcsok pedig továbbra is működnek.
Augusztus 14-től a domainellenőrzések eredményét 5 percig gyorsítótáraztuk, a „nincs regisztrálva” eredményeket is, így egy épp hozzáadott domain akár 5 percig is 403 választ adhatott. Mostantól csak a sikeres egyezéseket tároljuk gyorsítótárban; egy domain eltávolítása továbbra is akár 5 perc alatt lép érvénybe.
A beágyazási konzolban a kulcs utolsó használati idejét mostantól legfeljebb óránként egyszer rögzítjük, és a widgetbetöltések már nem számítanak látogatásnak a Bitculator saját oldalstatisztikáiban. A beágyazások felhasználási számait ez nem érinti.
Keskeny szélességen a heti sáv, valamint az éves, negyedéves és havi sáv mostantól egymástól függetlenül görgethető, így a hosszú heti sor húzása már nem mozdítja oldalra a rövidebb sávot.
Július 12. és 16. között a kalkulátorwidgetek és a piaci kapitalizáció-váltó új elrendezést és bemeneteket kapott, néhány szakaszt pedig eltávolítottunk: a piaci kapitalizáció-váltóból a picker, a kamatkalkulátorból a chart és a table, az adó- és a hitelkalkulátorból a results, a stakelés-kalkulátorból pedig a banner, a table és a chart szakaszt – ez utóbbi a napitól az évesig terjedő jutalmakat mostantól közvetlenül, soron belül sorolja fel. A látogatók mentett elrendezései alaphelyzetbe álltak; minden olyan layout vagy visible értéket építs újra, amely eltávolított szakaszt nevez meg.
A befogadó oldal elküldheti a widget ablakának a {type: 'bitculator-embed-host-growable'} üzenetet. Ekkor a widget lefelé nyitja meg a választóit, és beleszámítja őket a bitculator-embed-resize üzenetben jelentett magasságba; az üzenet nélkül a választók átfedésként nyílnak meg a rögzített kereten belül.
A /embed/zoom/{slug} mostantól egyetlen rácsban mutatja az éves, negyedéves, havi és heti hozamokat évenként, átlagsorral és nyerési arány szerinti összesítésekkel, valamint egy negyedéves „tornádó” nézettel. Ez váltja fel a korábbi negyedéves, havi és heti táblázatokat, és nincs külső kártyakerete.
A beágyazási konzol mostantól grafikonon mutatja a napi kérésszámot az aktuális számlázási időszakra.
A /{locale}/pricing/embed mostantól a /{locale}/crypto-tools oldalra irányít át, amely fizetéssel egybekötött csomagválasztót kapott, valamint egy widgetböngészőt, amely egyszerre egy widget előnézetét mutatja a kódrészlet-építő mellett.
Ez a referencia a /{locale}/documentation/embed/v1 címen indult el kódrészlet-építővel, a hitelesítés, a domainek, a kvóta és a csomagok leírásával, minden widget paramétereivel és kattintásra betöltődő előnézetekkel.
A beágyazásbetöltéseknek mostantól saját csomagjuk, számlázási időszakuk és számlálójuk van; az első két napjában a Data API is a beágyazási csomagból fogyasztott. A beágyazásikulcs-korlátodba csak a beágyazási kulcsok számítanak bele, a widget-URL-ben szereplő Data API-kulcs vagy lejárt kulcs 403 választ kap, a widgetválaszok pedig nem tartalmaznak X-Quota-* fejléceket.
Egy fizetős beágyazási csomag lemondása után a felhasználás a csomag lejártáig továbbra is a számlázási napodhoz igazodó időablakban számolódik, ahelyett hogy időszak közben naptári hónapra váltana, és a konzolban látható nullázási dátum a hónap végére eső számlázási napoknál is helyes.
A korai /api/v1/prices és /api/v1/widgets/convert/{from}/{to} JSON-végpontokat, amelyek beágyazási kulcsot fogadtak, felváltotta a Data API, amely csak a saját kulcsait fogadja el. A beágyazási kulcsokat a /user/developer/embed oldalon kezelheted.
A beágyazó hosztot kisbetűssé alakítjuk, és eltávolítjuk az esetleges záró pontot, mielőtt összevetjük a regisztrált domaineiddel.
A /{locale}/crypto-tools widgetoldal lett élő valutaváltóval, másolható kódrészlettel és a Free, Starter és Pro csomag összehasonlításával.
Az embed_key paraméterrel, de Referer vagy Origin fejléc nélkül érkező betöltés mostantól 403 választ kap; korábban kimaradt a domainellenőrzés. Hagyd meg a böngésző alapértelmezett hivatkozói szabályát, és ne állítsd be a referrerpolicy="no-referrer" attribútumot az iframe-en.
A kulcs nélküli, havi 1 000 betöltéses keret mostantól látogatói IP-címenként számít, minden oldal minden kulcs nélküli widgetjére együtt, nem pedig beágyazó domainenként egy-egy közös keretként.
Az április 4-i eltávolítás után a link visszakerült minden widget aljára. A bitculator.com megfelelő eszközére mutat, és nem kapcsolható ki.
Az építő kódrészletei visszatértek a puszta <iframe> elemhez; az április 3-án másolt kódrészletek egy burkolóelemet, egy külön Powered-by linket és egy automatikus átméretező <script> elemet is tartalmaztak. A widgeten belüli lábléclinket ugyanekkor eltávolítottuk, és május 2-án tért vissza.
Minden eszközoldal kapott egy építőt: illeszd be a beágyazási kulcsodat, válaszd ki a widget nyelvét, egy elrendezéssablont és a látható szakaszokat, majd állítsd be a szélességet, a magasságot, a sarkok lekerekítését és a lusta vagy azonnali betöltést – a kódrészlet és az élő előnézet együtt frissül.
A kalkulátorwidgetek és a piaci kapitalizáció-váltó elfogadják a ?visible= paramétert: az alapértelmezésként megjelenítendő szakaszazonosítók vesszővel elválasztott listáját. A látogató saját, a böngészőjében mentett választása elsőbbséget élvez.
A kulcsodat ?embed_key= formában add meg; a ?api_key= aliasként továbbra is működik. A konzol a /{locale}/user/developer/embed címre költözött, és az új kulcs teljes értéke egyszer, közvetlenül a létrehozása után jelenik meg.
A widgetoldalak még X-Frame-Options: SAMEORIGIN és frame-ancestors 'self' beállítással mentek ki, így a böngészők más domaineken nem voltak hajlandók megjeleníteni őket. Mostantól frame-ancestors * értéket küldenek, X-Frame-Options fejlécet pedig nem.
A március 22-én bevezetett csomagokból saját fizetési folyamattal rendelkező beágyazási csomagok lettek, az árazási oldal pedig a /{locale}/pricing/embed címre költözött. A korlátok nem változtak.
A DCA-, profit-, kamat-, adó-, hitel-, stakelés- és piaci kapitalizáció-váltó widgetek szakaszokra oszlanak, amelyeket a látogatók húzhatnak, átméretezhetnek és igazíthatnak; az elrendezés a böngészőjükben mentődik, és egy „Elrendezés visszaállítása” gombbal állítható alaphelyzetbe. A ?layout= adja meg a kezdő elrendezést, például c(stats::cc,settings::cc), ahol a c() egy oszlop, az r() egy sor, egy szakasz pedig id:width:alignment.
A widgetek kulcsot fogadnak el az URL-ben, és a kulcsos betöltésnek a konzolban regisztrált domainről kell érkeznie, különben 403 választ kap; a kulcs nélküli betöltések továbbra is megjelennek. A Free havi 10 000 betöltést, 1 domaint és 2 kulcsot enged, a Starter 50 000 betöltést, 3 domaint és 5 kulcsot, a Pro pedig 500 000 betöltést, 10 domaint és 10 kulcsot. A korlát felett a widget egy felhasználási korlátról tájékoztató oldalt mutat (HTTP 429).
A valutaváltó widget elvesztette az összehasonlító táblázatát, így a hideTable azóta hatástalan. A paramétert továbbra is elfogadja.
A widgetek minden magasságváltozáskor elküldik a szülőablaknak a {type: 'bitculator-embed-resize', height} üzenetet, így egy befogadó szkript átméretezheti az iframe-et, és amíg el nem készülnek, betöltési helyőrzőt mutatnak. Minden eszközoldal kapott egy másolható beágyazási kódrészletet.
Indulás: a valutaváltó (/{locale}/embed/converter/{from}/{to}), a zoom (/zoom/{slug}), a piaci kapitalizáció-váltó (/flip/{entity1}/{entity2}), valamint a /dca, /profit, /interest, /tax, /loan és /staking kalkulátorok. Minden widget elfogadja a ?compact=1 és a ?theme=dark paramétert, átlátszó a háttere, noindex jelölésű, és „Powered by Bitculator” linket tartalmaz.
Egy widgetverzió eltávolítását vagy egy korlát csökkentését itt és e-mailben, legalább hat hónappal előre jelentjük be – lásd a megszüntetési szabályzatot.