Bitculator predstavuje 8 SDKs

Dnes predstavujeme osem oficiálnych klientskych knižníc s otvoreným zdrojovým kódom pre Bitculator Data API: TypeScript, Python, PHP, Go, Rust, Java, C# a C++. Každá z nich pokrýva celé API - všetkých 85 koncových bodov v 15 skupinách zdrojov - a každá je dostupná pod licenciou MIT a zadarmo.

Ak ste už niekedy pripájali zdroj kryptomenových dát k backendu, obchodnému botovi, dashboardu alebo nástroju na export do tabuliek, poznáte tie nudné časti: autentifikačné hlavičky, stránkovacie slučky, opakovanie požiadaviek pri prekročení limitu, spracovanie chýb a nenápadné chyby čísel s pohyblivou desatinnou čiarkou, ktoré sa vkradnú, keď ceny prekročia ôsme desatinné miesto. SDK sú tu na to, aby ste túto infraštruktúru už nikdy nemuseli písať znova.

Nejde o strojovo generované kostry kódu z OpenAPI. Každé SDK tvorí ručne písaný, idiomatický kód pre daný ekosystém:

• Go prijíma ako prvý parameter context.Context a vracia stránkovacie iterátory iter.Seq2 využívajúce range-over-func.
• Rust ponúka generické typované odpovede a klienta konfigurovaného pomocou buildera.
• C# je plne asynchrónne s automatickým stránkovaním cez IAsyncEnumerable a podporou CancellationToken.
• TypeScript používa natívny fetch, stránkovanie cez for await a parametre v camelCase s nulovými závislosťami.
• Python používa výhradne štandardnú knižnicu.
• PHP používa cURL bez závislostí.
• C++ tvorí jediný hlavičkový súbor.
•  

Rovnaké rozhranie, prirodzené používanie. Ak zmeníte jazyk, SDK už poznáte.

Všetkých osem zdieľa rovnaké jadro overené v praxi, takže všade platia rovnaké záruky:

1. Úplné pokrytie - každý koncový bod v referenčnej dokumentácii API má jednu metódu v jednej z 15 skupín zdrojov: mince, ceny, trhy, burzy, peňaženky, globálny trh, sentiment, indikátory, likvidácie, konverzia, kalkulačky, redakčný obsah, upozornenia, webhooky a metadáta.
2. Presnosť desatinných čísel v reťazcoch - ceny, kurzy a množstvá v obehu prichádzajú ako reťazce, nikdy ako čísla s pohyblivou desatinnou čiarkou so stratou presnosti. Dostanete presne to, čo uviedol trh.
3. Automatické stránkovanie - iterujte cez Page a SDK za vás načíta ďalšie stránky.
4. Inteligentné opakovanie požiadaviek - pri chybách 429 sa rešpektuje Retry-After; pri dočasných chybách 5xx a zlyhaniach siete sa opakujú iba idempotentné volania, takže nestabilné pripojenie nikdy nevytvorí upozornenie alebo webhook dvakrát.
5. Typované chyby - chyby autentifikácie, oprávnení, validácie, limitu požiadaviek a servera majú samostatné typy, ktoré môžete zachytiť, pričom každý obsahuje stabilný chybový kód API.
6. Aktuálny stav kvóty - hlavičky X-Quota-* z každej odpovede sa spracujú a uložia v klientovi, takže vždy viete, ako ste na tom tento mesiac.

Každé SDK má vlastný repozitár na GitHub a je publikované v registri svojho ekosystému:
 

Logá, inštalačné príkazy a odkazy na registre pre všetkých osem nájdete aj v sekcii SDK na stránke API. 

SDK sa riadia SemVer a vydávajú sa synchronizovane: keď API získa nový koncový bod, každé SDK získa príslušnú metódu v tom istom vydaní. Rozhodujúcim zdrojom je verejná špecifikácia OpenAPI a celé rozhranie je zdokumentované - so spustiteľnými príkladmi v ôsmich programovacích jazykoch - v dokumentácii API.

A ak radšej nechcete inštalovať vôbec nič: SDK nepotrebujete. Data API je obyčajné HTTP s hlavičkou Bearer - SDK len robia z pohodlného postupu predvolený spôsob práce.

Prečítajte si o plánoch a kvótach na stránke Data API - k dispozícii je aj bezplatný plán bez potreby platobnej karty.

Vytvorte si kľúč vo vývojárskej konzole a môžete začať.

Radi uvidíme, čo vytvoríte. Hlásenia problémov a pull requesty prijímame v každom repozitári na github.com/bitculator.