الأعمال التحضيرية
- سجّل الدخول إلى منصة AceDataCloud.
- أنشئ رمز حساب في وحدة تحكم Account Token، واحفظه فورًا.
- إذا كنت بحاجة إلى تضييق النطاق، فاحصل على المعرّف المقابل من قائمة طلبات الخدمة، أو قائمة بيانات اعتماد API، أو قائمة API.
نظرة عامة على الواجهة
معلمات الاستعلام
لا يزال من الممكن استخدام
start_time / end_time كأسماء مستعارة للتوافق مع العملاء القدامى، وتستخدم التكاملات الجديدة بشكل موحّد created_at_from / created_at_to. تشمل صيغة التاريخ لـ created_at_to ذلك اليوم التقويمي، أي باستخدام منتصف ليل اليوم التالي كحد فاصل.
أمثلة الطلبات
استعلم عن التجميع اليومي/API للشهر الحالي بتوقيت بكين، مع تضمين بُعد النموذج:مثال الاستجابة
حقول الاستجابة
تعتمد وحدة الرصيد على
service.unit الخاص بـ Application ذي الصلة. إذا كان الاستعلام يتضمن خدمات بوحدات مختلفة، فقم أولًا بالإحصاء بشكل منفصل حسب service_id أو application_id، لتجنب المقارنة المباشرة أو الجمع.
عندما لا يكون وقت الانتهاء أكبر من وقت البدء، تُرجع الواجهة بنية فارغة كاملة: items=[]، وtotal=0، وapis={}، وrequests=0، وmodels=[].
اقتراحات الأخطاء والأداء
- لا تفعّل
include_modelsافتراضيًا؛ فعّله فقط عندما يحتاج التقرير فعلًا إلى تقسيم حسب النموذج. - بالنسبة إلى الاستعلامات واسعة النطاق، أعطِ الأولوية للتقسيم حسب
service_idأوapplication_id، لتجنب خلط الوحدات وخفض تكلفة الاستعلام. - لا تُستكمل التواريخ التي ليس فيها استدعاءات بصفر تلقائيًا؛ ويجب على العميل استكمال محور التاريخ قبل الرسم البياني.
الخطوات التالية
- عرض سجلات الاستدعاء: تحديد التفاصيل التي تشكّل النتائج المجمّعة.
- تصدير حجم الاستدعاءات: تنزيل تفاصيل CSV الكاملة.
- عرض تفاصيل طلب الخدمة: تأكيد الرصيد والوحدة.

