الانتقال إلى المحتوى الرئيسي
تجميع عدد الطلبات والمقدار الفعلي المخصوم للحساب الحالي حسب التاريخ وواجهة API، وهو مناسب لإعداد التقارير الشهرية، والمخططات الاتجاهية، وتحليل التكلفة. استخدم قائمة سجلات الاستدعاء عند الحاجة إلى استكشاف الأخطاء وإصلاحها لكل سجل، واستخدم تصدير حجم الاستدعاءات عند الحاجة إلى تفاصيل كاملة دون اتصال. نطاق الاستعلام لسجلات الاستدعاء وملخصات الفوترة هو آخر 60 يومًا؛ بينما يُحتفظ بنصوص الطلبات والاستجابات بشكل منفصل لآخر 30 يومًا. لا يؤثر انتهاء صلاحية النص على الرسوم الفعلية أو الاستخدام أو الإحصاءات المجمّعة لذلك السجل.

الأعمال التحضيرية

  1. سجّل الدخول إلى منصة AceDataCloud.
  2. أنشئ رمز حساب في وحدة تحكم Account Token، واحفظه فورًا.
  3. إذا كنت بحاجة إلى تضييق النطاق، فاحصل على المعرّف المقابل من قائمة طلبات الخدمة، أو قائمة بيانات اعتماد API، أو قائمة API.
راجع إدارة رموز الحساب للحصول على شرح كامل للرمز. تستخدم هذه الواجهة Account Token، ولا تستخدم Credential الخاص بالعمل.

نظرة عامة على الواجهة

معلمات الاستعلام

لا يزال من الممكن استخدام start_time / end_time كأسماء مستعارة للتوافق مع العملاء القدامى، وتستخدم التكاملات الجديدة بشكل موحّد created_at_from / created_at_to. تشمل صيغة التاريخ لـ created_at_to ذلك اليوم التقويمي، أي باستخدام منتصف ليل اليوم التالي كحد فاصل.

أمثلة الطلبات

استعلم عن التجميع اليومي/API للشهر الحالي بتوقيت بكين، مع تضمين بُعد النموذج:
استعلم عن استخدام أسبوع لـ Application محدد:
مثال Python:

مثال الاستجابة

حقول الاستجابة

تعتمد وحدة الرصيد على service.unit الخاص بـ Application ذي الصلة. إذا كان الاستعلام يتضمن خدمات بوحدات مختلفة، فقم أولًا بالإحصاء بشكل منفصل حسب service_id أو application_id، لتجنب المقارنة المباشرة أو الجمع. عندما لا يكون وقت الانتهاء أكبر من وقت البدء، تُرجع الواجهة بنية فارغة كاملة: items=[]، وtotal=0، وapis={}، وrequests=0، وmodels=[].

اقتراحات الأخطاء والأداء

  • لا تفعّل include_models افتراضيًا؛ فعّله فقط عندما يحتاج التقرير فعلًا إلى تقسيم حسب النموذج.
  • بالنسبة إلى الاستعلامات واسعة النطاق، أعطِ الأولوية للتقسيم حسب service_id أو application_id، لتجنب خلط الوحدات وخفض تكلفة الاستعلام.
  • لا تُستكمل التواريخ التي ليس فيها استدعاءات بصفر تلقائيًا؛ ويجب على العميل استكمال محور التاريخ قبل الرسم البياني.

الخطوات التالية