البدء باستخدام API المجمع
اقرأ إحصاءات المجمع وإحصاءات كل معدِّن المباشرة برمجيًا: نقاط النهاية العامة بصيغة JSON، وكيف تستعلم عن عنوانك، وملاحظات الاستخدام العادل.
الغرض من واجهة API
كل ما تعرضه لوحة التحكم تقدّمه واجهة JSON API عامة للقراءة فقط، لذا يمكنك بناء أداة المراقبة الخاصة بك، أو لوحة تحكم منزلية، أو بوت، أو جدول بيانات يتتبع تعدينك. وهي توفّر إحصاءات المجمع كله (معدل التجزئة، صعوبة الشبكة، الكتل، الدفعات) وإحصاءات كل معدِّن لأي عنوان، دون مفتاح ودون حساب.
إحصاءات المجمع كله
تُرجع نقطة نهاية إحصاءات المجمع الأرقام نفسها التي تراها في الترويسة وفي لوحة التحكم: معدل تجزئة المجمع ومعدل تجزئة الشبكة، والمعدِّنين المتصلين، والصعوبة، وآخر الكتل والدفعات الأخيرة. اطلبها مثل أي عنوان URL بصيغة JSON:
curl https://quantus.herominers.com/api/statsإحصاءات المعدِّن الخاصة بك
لقراءة عنوان واحد، مرّره إلى نقطة نهاية إحصاءات المعدِّن. تتضمن الاستجابة معدل التجزئة لذلك العنوان، وعمّاله، وأرصدته، ودفعاته الأخيرة، أي البيانات الخام التي تقف خلف صفحة لوحة التحكم الخاصة بك:
curl https://quantus.herominers.com/api/stats_address?address=YOUR_QTC_ADDRESSالاستخدام العادل
واجهة API موجودة لتُستخدم، لكن استعلم منها بلطف: الأرقام الأساسية لا تتحدّث إلا كل فترة، لذا يكفي طلب واحد كل دقيقة أو دقيقتين، أما إغراقها بطلبات أكثر بكثير فلا يفعل سوى إهدار عرض النطاق لدى الطرفين دون أن يمنحك بيانات أحدث. خزّن ما تجلبه مؤقتًا، وابنِ أداتك على وتيرة التحديث نفسها التي تستخدمها لوحة التحكم.