A Bitculator 8 API SDK-t ad ki
Ma nyolc hivatalos, nyílt forráskódú klienskönyvtárat adunk ki a Bitculator Data API használatához: TypeScript, Python, PHP, Go, Rust, Java, C# és C++ nyelven. Mindegyik lefedi a teljes API-t - mind a 85 végpontot 15 erőforráscsoportban -, és mindegyik MIT-licencű, ingyenesen használható.
Ha valaha bekötöttél már kriptós adatfolyamot egy backendbe, kereskedési botba, irányítópultba vagy táblázatexportálóba, ismered az unalmas részeket: hitelesítési fejlécek, lapozási ciklusok, újrapróbálkozások a híváskorlát miatt, hibafeldolgozás és azok az alattomos lebegőpontos hibák, amelyek akkor jelentkeznek, amikor az árak túllépnek a nyolcadik tizedesjegyen. Az SDK-k azért készültek, hogy ezt a háttérmunkát soha többé ne kelljen leprogramoznod.
Kézzel írt, nem generált
Ezek nem géppel generált OpenAPI-kódvázak. Minden SDK kézzel írt, idiomatikus kód a saját ökoszisztémájához:
- A Go első paramétere context.Context, és iter.Seq2 típusú, range-over-func lapozókat ad vissza.
- A Rust generikus, típusos válaszokat és builderrel konfigurálható klienst ad.
- A C# teljesen aszinkron, IAsyncEnumerable alapú automatikus lapozással és CancellationToken támogatással.
- A TypeScript natív fetch hívásokat, 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árra épül.
- A PHP függőségmentes, cURL-alapú.
- A C++ egyetlen fejlécfájl.
Azonos felület, natív élmény. Ha nyelvet váltasz, az SDK-t már ismered.
Amit minden SDK elvégez helyetted
Mind a nyolc ugyanarra a gyakorlatban bevált alapra épül, így mindenhol azonos garanciákat kapsz:
- Teljes lefedettség - az API-referenciában szereplő minden végpont egy-egy metódus a 15 erőforráscsoport valamelyiké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.
- Tizedes pontosság szövegesen - az árak, árfolyamok és kínálati mennyiségek karakterláncként érkeznek, soha nem pontosságvesztő lebegőpontos számként. Pontosan azt kapod, amit a piac mutatott.
- Automatikus lapozás - iterálj egy Page objektumon, és az SDK lekéri helyetted a következő oldalakat.
- Intelligens újrapróbálkozások - a 429-es válaszoknál figyelembe veszi a Retry-After fejlécet; átmeneti 5xx és hálózati hibáknál csak idempotens hívásokat próbál újra, így egy akadozó kapcsolat soha nem hoz létre kétszer egy riasztást vagy webhookot.
- Típusos hibák - a hitelesítési, jogosultsági, validációs, híváskorlát- és szerverhibák külön elkapható típusok, amelyek mind tartalmazzák az API állandó hibakódját.
- Aktuális kvóta - a kliens minden válaszból feldolgozza az X-Quota-* fejléceket, így mindig tudod, hol tartasz az adott hónapban.
Telepítsd a csomagkezelődből
Minden SDK saját GitHub-repozitóriumban található, és a nyelv saját csomagtárában érhető el:
| Nyelv | Telepítés | Forrás |
| TypeScript / Node | npm install @bitculator/sdk | bitculator-typescript-sdk |
| Python | pip install bitculator | bitculator-python-sdk |
| PHP | composer require bitculator/sdk | bitculator-php-sdk |
| Go | go get github.com/bitculator/bitculator-go-sdk | bitculator-go-sdk |
| Rust | cargo add bitculator | bitculator-rust-sdk |
| Java | com.bitculator:bitculator (Maven) | bitculator-java-sdk |
| C# / .NET | dotnet add package Bitculator | bitculator-dotnet-sdk |
| C++ | csak fejlécfájl, CMake bitculator::bitculator | bitculator-cpp-sdk |
Mind a nyolc logóját, telepítési parancsait és csomagtári hivatkozásait összegyűjtöttük az API-oldal SDK-szakaszában is.
Verziózás az API-val összhangban
Az SDK-k a SemVer szabályait követik, és összehangoltan jelennek meg: amikor az API új végpontot kap, minden SDK ugyanabban a kiadásban megkapja a hozzá tartozó metódust. A mérvadó forrás a nyilvános OpenAPI-specifikáció, a teljes felület dokumentációja pedig - nyolc programozási nyelven futtatható példákkal - az API-dokumentációban található.
Ha pedig inkább semmit sem telepítenél: nincs szükséged SDK-ra. A Data API egyszerű HTTP Bearer fejléccel - az SDK-k csak alapértelmezetté teszik a kényelmes megoldást.
Kezdj el fejleszteni
A csomagokról és kvótákról a Data API oldalán olvashatsz - ingyenes csomag is van, bankkártya sem kell hozzá.
Hozz létre egy kulcsot a fejlesztői konzolon, és már kezdheted is.
Kíváncsian várjuk, mit készítesz. Minden repozitóriumban várjuk a hibajegyeket és pull requesteket a github.com/bitculator oldalon.

