تُطلق Bitculator ثماني حزم SDK رسمية لـ API
نطلق اليوم ثماني مكتبات رسمية مفتوحة المصدر لـ واجهة Bitculator للبيانات API: TypeScript وPython وPHP وGo وRust وJava وC# وC++. تغطي كل مكتبة منها واجهة API كاملة - جميع نقاط النهاية الـ85 ضمن 15 مجموعة موارد - وكلها مرخصة بموجب MIT ومجانية الاستخدام.
إذا سبق لك ربط موجز بيانات العملات المشفرة بخلفية تطبيق أو روبوت تداول أو لوحة معلومات أو أداة تصدير جداول بيانات، فأنت تعرف الجوانب المملة: ترويسات المصادقة، وحلقات ترقيم الصفحات، وإعادة المحاولة عند تجاوز حد المعدل، وتحليل الأخطاء، وأخطاء الفاصلة العائمة الدقيقة التي تظهر عندما تتجاوز الأسعار ثماني منازل عشرية. صُممت حزم SDK لتجنّب كتابة هذا العمل التمهيدي مرة أخرى.
كُتبت يدويًا، ولم تُولّد آليًا
هذه ليست هياكل OpenAPI أولية مولّدة آليًا. كُتبت كل حزمة SDK يدويًا بأسلوب يتلاءم مع بيئتها البرمجية:
- تبدأ Go بـ context.Context، وتعيد أدوات ترقيم صفحات iter.Seq2 القائمة على range-over-func.
- توفر Rust استجابات عامة ذات أنواع محددة وعميلًا مضبوطًا باستخدام نمط builder.
- تعمل C# بالكامل بأسلوب غير متزامن، مع ترقيم تلقائي للصفحات باستخدام IAsyncEnumerable ودعم CancellationToken.
- تستخدم TypeScript واجهة fetch الأصلية، وترقيم الصفحات باستخدام for await، ومعلمات camelCase، مع عدم وجود أي تبعيات.
- تعتمد Python على المكتبة القياسية فقط.
- تستخدم PHP cURL دون تبعيات.
- تأتي C++ في ملف ترويسة واحد.
الواجهة واحدة، لكن التجربة مألوفة في كل لغة. إذا انتقلت إلى لغة أخرى، فستعرف كيفية استخدام حزمة SDK مسبقًا.
ما الذي تقدمه لك كل حزمة SDK
تشترك الحزم الثماني في أساس واحد مختبَر ميدانيًا، لذا فهي تقدم الضمانات نفسها في كل بيئة:
- تغطية كاملة - لكل نقطة نهاية في مرجع API طريقة ضمن إحدى مجموعات الموارد الـ15: العملات، والأسعار، والأسواق، والمنصات، والمحافظ، والسوق العالمي، ومعنويات السوق، والمؤشرات، والتصفيات، والتحويل، والحاسبات، والمحتوى التحريري، والتنبيهات، وwebhooks، والبيانات الوصفية.
- دقة السلاسل العشرية - تصل الأسعار والمعدلات والمعروض كسلاسل نصية، وليس كأرقام فاصلة عائمة تفقد الدقة. ستحصل على القيمة نفسها التي يعرضها السوق.
- ترقيم تلقائي للصفحات - تصفح صفحات النتائج، وستجلب حزمة SDK الصفحات التالية نيابةً عنك.
- إعادة محاولة ذكية - تحترم استجابات 429 ترويسة Retry-After؛ وتُعاد المحاولة عند أخطاء 5xx المؤقتة وأعطال الشبكة للطلبات القابلة للتكرار الآمن فقط، فلا يؤدي الاتصال غير المستقر أبدًا إلى إنشاء تنبيه أو webhook مرتين.
- أخطاء محددة الأنواع - أخطاء المصادقة والصلاحيات والتحقق من الصحة وحد المعدل والخادم لها أنواع منفصلة يمكنك التعامل معها، ويحمل كل منها رمز الخطأ الثابت الخاص بواجهة 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++ | header-only, CMake bitculator::bitculator | bitculator-cpp-sdk |
تجد أيضًا شعارات الحزم وأوامر التثبيت وروابط السجلات الثمانية في قسم SDK في صفحة API.
إصدارات متزامنة مع إصدارات API
تتبع حزم SDK نظام SemVer وتصدر بالتزامن: عندما تكتسب API نقطة نهاية جديدة، تكتسب كل حزمة SDK الطريقة المقابلة في الإصدار نفسه. والمصدر المعتمد هو مواصفات OpenAPI العامة، ووُثقت الواجهة بأكملها - مع أمثلة قابلة للتشغيل بثماني لغات برمجة - في توثيق API.
وإذا كنت تفضل عدم تثبيت أي شيء إطلاقًا، فلا حاجة إلى حزمة SDK. تعمل واجهة Data API عبر HTTP عادي مع ترويسة Bearer - وكل ما تفعله حزم SDK هو جعل الخيار الأسهل هو الخيار الافتراضي.
ابدأ بالبناء
اطّلع على الخطط والحصص في صفحة Data API - تتوفر خطة مجانية ولا حاجة إلى بطاقة دفع.
أنشئ مفتاحًا في لوحة المطور، وستكون جاهزًا للبدء.
يسعدنا أن نرى ما ستبنيه. باب فتح البلاغات وطلبات السحب مفتوح في كل مستودع على github.com/bitculator.