A Bitculator bemutat 8 SDK-t

Ma elindítjuk a nyolc hivatalos, nyílt forráskódú klienskönyvtárat a Bitculator Data API-hoz: TypeScript, Python, PHP, Go, Rust, Java, C# és C++. Mindegyik lefedi a teljes API-t – mind a 85 végpontot a 15 erőforráscsoportban –, és mindegyik MIT-licencű, valamint ingyenesen használható.

Ha valaha kötöttél már kriptovaluta-adatfolyamot backendhez, kereskedési bothoz, irányítópulthoz vagy táblázatexportálóhoz, ismered az unalmas részeket: hitelesítési fejlécek, lapozási ciklusok, újrapróbálkozás a sebességkorlátozás miatt, hibák feldolgozása és az alattomos lebegőpontos hibák, amelyek akkor jönnek elő, amikor az árak elérik a nyolcadik tizedesjegyet. Az SDK-k azért készültek, hogy soha többé ne kelljen megírnod ezt az infrastruktúrát.

Ezek nem géppel generált OpenAPI-vázak. Mindegyik SDK az adott ökoszisztémához kézzel írt, idiomatikus kód:

• A Go első argumentumként context.Context-et használ, és iter.Seq2 range-over-func lapozókat ad vissza.
• A Rust általánosan típusos válaszokat és builderrel konfigurálható klienst kínál.
• A C# teljesen aszinkron, IAsyncEnumerable automatikus lapozással és CancellationToken-támogatással.
• A TypeScript natív fetch-et, for await lapozást és camelCase paramétereket használ, függőségek nélkül.
• A Python kizárólag a standard könyvtárat használja.
• A PHP függőségek nélküli cURL-t használ.
• A C++ egyetlen fejlécfájlból áll.
•  

Ugyanaz a felület, az adott nyelvre szabva. Ha nyelvet váltasz, az SDK már ismerős lesz.

Mind a nyolc ugyanazt a gyakorlatban bevált alaprendszert használja, így mindenhol ugyanazokat a garanciákat nyújtják:

1. Teljes lefedettség – az API-referencia minden végpontja egy metódusként érhető el a 15 erőforráscsoport egyikében: érmék, árak, piacok, tőzsdék, tárcák, globális piac, hangulat, indikátorok, likvidálások, átváltás, kalkulátorok, szerkesztőségi tartalmak, riasztások, webhookok és metaadatok.
2. Pontosság decimális karakterláncokkal – az árak, ráták és kínálati adatok karakterláncként érkeznek, soha nem veszteséges lebegőpontos számként. Azt kapod, amit a piac mutatott.
3. Automatikus lapozás – járd végig az oldalakat, az SDK pedig lekéri helyetted a következőket.
4. Intelligens újrapróbálkozás – a 429-es válaszoknál figyelembe veszi a Retry-After értékét; az átmeneti 5xx hibák és hálózati hibák esetén csak idempotens hívásoknál próbálkozik újra, így egy akadozó kapcsolat nem hoz létre kétszer riasztást vagy webhookot.
5. Típusos hibák – a hitelesítési, jogosultsági, érvényesítési, sebességkorlátozási és szerverhibák külön típusúak, amelyeket elkaphatsz; mindegyik tartalmazza az API stabil hibakódját.
6. Élő kvótaadatok – minden válaszból feldolgozza az X-Quota-* fejléceket, és hozzáadja őket a klienshez, így mindig tudod, hogyan állsz az adott hónapban.

Minden SDK külön GitHub-tárolóban található, és az adott nyelv csomagnyilvántartásában érhető el:
 

A logók, telepítési parancsok és csomagnyilvántartási hivatkozások mind a nyolchoz megtalálhatók az API-oldal SDK-szekciójában. 

Az SDK-k a SemVer szerint, összehangolt kiadásokban jelennek meg: amikor az API új végponttal bővül, minden SDK ugyanabban a kiadásban megkapja a hozzá tartozó metódust. A hiteles forrás a nyilvános OpenAPI-specifikáció, a teljes funkcionalitás pedig dokumentálva van – nyolc programozási nyelven futtatható példákkal – az API-dokumentációban.

Ha pedig egyáltalán nem szeretnél semmit telepíteni, SDK-ra sincs szükséged. A Data API egyszerű HTTP Bearer-fejléccel – az SDK-k csupán alapértelmezetté teszik a kényelmesebb megoldást.

A csomagokról és kvótákról a Data API oldalán olvashatsz – van ingyenes csomag, bankkártya sem kell hozzá.

Hozz létre egy kulcsot a fejlesztői konzolban, és már kezdheted is.

Szívesen megnézzük, mit építesz. Minden tárolóban várjuk a hibajelentéseket és a pull requesteket a github.com/bitculator címen.