البدء باستخدام API المجمع

ماذا يمكنني أن أفعل بواجهة API الخاصة بالمجمع؟

للمجمع واجهة API عامة بصيغة JSON للقراءة فقط، تقدّم كل ما تعرضه لوحة التحكم. ولا تحتاج مفتاحًا ولا حسابًا.

يمكنك استخدامها لبناء مراقبتك الخاصة، أو لوحة تحكم منزلية، أو بوت، أو جدول بيانات يتتبع تعدينك. وهي تعطيك نوعين من البيانات:

• إحصاءات المجمع كله: معدل التجزئة، وصعوبة الشبكة، والكتل، والدفعات.
• إحصاءات أي عنوان على حدة.

كيف أحصل على إحصاءات المجمع كله؟

نقطة نهاية إحصاءات المجمع تعيد الأرقام نفسها التي تراها في الترويسة وفي لوحة التحكم:

• معدل تجزئة المجمع والشبكة.
• المعدِّنون المتصلون.
• الصعوبة.
• آخر الكتل.
• الدفعات الأخيرة.

اجلبها كأي رابط JSON:

curl https://qubitcoin.herominers.com/api/stats

كيف أحصل على إحصاءات عنواني أنا؟

لقراءة عنوان واحد، مرّره إلى نقطة نهاية إحصاءات المعدِّن. استبدل YOUR_QTC_ADDRESS بعنوان محفظتك.

يحمل الجواب معدل تجزئة ذلك العنوان، وعمّاله، وأرصدته، ودفعاته الأخيرة. وهو البيانات الخام وراء صفحة لوحة التحكم الخاصة بك:

curl https://qubitcoin.herominers.com/api/stats_address?address=YOUR_QTC_ADDRESS

كم مرة يجب أن أستعلم من الواجهة؟

مرة كل دقيقة أو دقيقتين تكفي وزيادة. الواجهة موجودة لتُستخدم، لكن استعلم منها بلطف.

الأرقام وراءها لا تتحدّث إلا كل فترة. والاستعلام أكثر من ذلك بكثير يهدر عرض النطاق على الطرفين ولا يعطيك بيانات أحدث.

خزّن ما تجلبه مؤقتًا. وابنِ عملك على إيقاع التحديث نفسه الذي تستخدمه لوحة التحكم.