Bitculator เปิดตัว API SDK 8 ภาษา
วันนี้เราเปิดตัวไลบรารีไคลเอนต์โอเพนซอร์สอย่างเป็นทางการแปดชุดสำหรับ Bitculator Data API: TypeScript, Python, PHP, Go, Rust, Java, C# และ C++ ทุกชุดรองรับ API อย่างครบถ้วน - ทั้ง 85 endpoint ใน 15 กลุ่มทรัพยากร - และทุกชุดใช้สัญญาอนุญาต MIT และใช้งานได้ฟรี.
หากคุณเคยเชื่อมฟีดข้อมูลคริปโตเข้ากับระบบแบ็กเอนด์ บอตเทรด แดชบอร์ด หรือเครื่องมือส่งออกสเปรดชีต คุณคงรู้จักส่วนที่น่าเบื่อดี: เฮดเดอร์ยืนยันตัวตน ลูปดึงข้อมูลทีละหน้า การลองใหม่เมื่อเจอขีดจำกัดอัตราคำขอ การแยกวิเคราะห์ข้อผิดพลาด และบั๊กของเลขทศนิยมแบบ float ที่แฝงตัวเข้ามาเมื่อราคามีทศนิยมเกินแปดตำแหน่ง. SDK เหล่านี้มีไว้เพื่อให้คุณไม่ต้องเขียนโค้ดพื้นฐานเหล่านั้นอีก.
เขียนด้วยมือ ไม่ได้สร้างโดยอัตโนมัติ
นี่ไม่ใช่โค้ดโครงร่าง OpenAPI ที่เครื่องสร้างขึ้น. SDK แต่ละชุดเป็นโค้ดที่เขียนด้วยมือ ตามแนวทางของภาษาในระบบนิเวศนั้น:
- Go รับ context.Context เป็นอาร์กิวเมนต์แรก และคืนตัวแบ่งหน้าข้อมูล iter.Seq2 แบบ range-over-func.
- Rust มีข้อมูลตอบกลับแบบ generic ที่ระบุชนิดข้อมูล และไคลเอนต์ที่กำหนดค่าผ่าน builder.
- C# ทำงานแบบ async ทั้งหมด พร้อมการดึงข้อมูลทีละหน้าอัตโนมัติด้วย IAsyncEnumerable และรองรับ CancellationToken.
- TypeScript ใช้ fetch ที่มีมาในตัว การดึงข้อมูลทีละหน้าด้วย for await และพารามิเตอร์แบบ camelCase โดยไม่พึ่งพาไลบรารีภายนอก.
- Python ใช้เฉพาะ stdlib.
- PHP ใช้ cURL โดยไม่พึ่งพาไลบรารีภายนอก.
- C++ มีเพียงไฟล์เฮดเดอร์เดียว.
อินเทอร์เฟซเดียวกัน ใช้งานได้เป็นธรรมชาติตามแต่ละภาษา. หากคุณเปลี่ยนภาษา คุณก็รู้วิธีใช้ SDK อยู่แล้ว.
สิ่งที่ SDK ทุกชุดทำให้คุณ
ทั้งแปดชุดใช้แกนหลักเดียวกันที่ผ่านการใช้งานจริงมาอย่างหนัก จึงรับประกันการทำงานแบบเดียวกันทั้งหมด:
- รองรับครบถ้วน - ทุก endpoint ในเอกสารอ้างอิง API มีเมธอดหนึ่งรายการในหนึ่งใน 15 กลุ่มทรัพยากร: เหรียญ ราคา ตลาด กระดานเทรด กระเป๋าเงิน ตลาดโลก ความเชื่อมั่น อินดิเคเตอร์ การล้างพอร์ต การแปลง เครื่องคำนวณ บทความ การแจ้งเตือน เว็บฮุก และเมตา.
- ความแม่นยำของทศนิยมในรูปสตริง - ราคา อัตรา และอุปทานจะส่งมาเป็นสตริง ไม่ใช่ float ที่สูญเสียความแม่นยำ. ตลาดรายงานอย่างไร คุณก็ได้รับอย่างนั้น.
- ดึงข้อมูลทีละหน้าอัตโนมัติ - วนอ่าน Page แล้ว SDK จะดึงหน้าถัดไปให้คุณ.
- ลองใหม่อย่างชาญฉลาด - ข้อผิดพลาด 429 จะทำตาม Retry-After ส่วนข้อผิดพลาด 5xx ชั่วคราวและเครือข่ายขัดข้องจะลองใหม่เฉพาะการเรียกที่ทำซ้ำแล้วให้ผลเดิม ดังนั้นการเชื่อมต่อที่ไม่เสถียรจะไม่สร้างการแจ้งเตือนหรือเว็บฮุกซ้ำ.
- ข้อผิดพลาดแยกตามชนิด - ข้อผิดพลาดด้านการยืนยันตัวตน สิทธิ์ การตรวจสอบความถูกต้อง ขีดจำกัดอัตราคำขอ และเซิร์ฟเวอร์ แยกเป็นคนละชนิดให้คุณดักจับได้ โดยแต่ละชนิดมีรหัสข้อผิดพลาดที่คงที่ของ API.
- โควตาแบบเรียลไทม์ - เฮดเดอร์ X-Quota-* จากทุกการตอบกลับจะถูกแยกวิเคราะห์และบันทึกไว้ในไคลเอนต์ คุณจึงรู้สถานะการใช้งานของเดือนนี้ได้เสมอ.
ติดตั้งผ่านตัวจัดการแพ็กเกจของคุณ
SDK แต่ละชุดมีที่เก็บโค้ด GitHub ของตัวเอง และเผยแพร่ในแหล่งรวมแพ็กเกจของแต่ละภาษา:
| ภาษา | ติดตั้ง | ซอร์สโค้ด |
| 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++ | เฉพาะเฮดเดอร์, CMake bitculator::bitculator | bitculator-cpp-sdk |
โลโก้ คำสั่งติดตั้ง และลิงก์แหล่งรวมแพ็กเกจของทั้งแปดชุดยังรวบรวมไว้ในส่วน SDK ของหน้า API.
อัปเดตเวอร์ชันไปพร้อมกับ API
SDK ใช้ SemVer และออกรุ่นพร้อมกัน: เมื่อ API เพิ่ม endpoint ทุก SDK จะเพิ่มเมธอดนั้นในรุ่นเดียวกัน. แหล่งอ้างอิงหลักคือข้อกำหนด OpenAPI ที่เปิดเผยต่อสาธารณะ และมีเอกสารครอบคลุมอินเทอร์เฟซทั้งหมด - พร้อมตัวอย่างที่รันได้ในแปดภาษาโปรแกรม - อยู่ในเอกสาร API.
และหากคุณไม่อยากติดตั้งอะไรเลย: คุณไม่จำเป็นต้องใช้ SDK. Data API ใช้ HTTP ธรรมดาพร้อมเฮดเดอร์ Bearer - SDK เพียงช่วยให้วิธีที่ใช้งานสะดวกเป็นวิธีเริ่มต้น.
เริ่มพัฒนา
อ่านเกี่ยวกับแพ็กเกจและโควตาได้ที่หน้า Data API - มีแพ็กเกจฟรี ไม่ต้องใช้บัตร.
สร้างคีย์ในคอนโซลนักพัฒนา แล้วคุณก็พร้อมเริ่มต้น.
เราอยากเห็นสิ่งที่คุณพัฒนา. ทุกที่เก็บโค้ดเปิดรับ issue และ pull request ที่ github.com/bitculator.