Bitculator تطلق 8 حزم SDK لواجهة API
نطلق اليوم ثماني مكتبات عميل رسمية مفتوحة المصدر لواجهة Bitculator Data 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 دالة واحدة ضمن إحدى مجموعات الموارد الخمس عشرة: العملات، والأسعار، والأسواق، ومنصات التداول، والمحافظ، والسوق العالمية، ومعنويات السوق، والمؤشرات، والتصفيات، والتحويل، والحاسبات، والمحتوى التحريري، والتنبيهات، وwebhooks، والبيانات الوصفية.
- دقة الأعداد العشرية كسلاسل نصية - تصل الأسعار والمعدلات والمعروض كسلاسل نصية، وليس كأعداد فاصلة عائمة تفقد الدقة. تحصل على ما أعلنه السوق تمامًا.
- ترقيم صفحات تلقائي - تكرّر عبر Page وستجلب حزمة 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++ | ملف ترويسة فقط، 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.