ما يتم الاستعلام عنه في هذه الصفحة هو تدفق الاستدعاءات الخاص بالحساب نفسه. إذا كنت تريد فقط عرض إحصاءات الاستدعاءات العامة لواجهة API معينة على المنصة بالكامل، فيرجى استخدام إحصاءات استدعاءات API.
نطاق الاحتفاظ بالبيانات
يتم الاحتفاظ بسجلات الاستدعاء وملخصات الفوترة لآخر 60 يومًا؛ ويتم الاحتفاظ بنصوص الطلبات والاستجابات لمدة آخر 30 يومًا. لا يزال بالإمكان الاستعلام في السجلات التي عمرها 30–60 يومًا عن الملخصات مثل trace والحالة والوقت والنموذج والاستخدام والرسوم الفعلية، ولكنmetadata.request وmetadata.response في التفاصيل لن تعود. يتم الاحتفاظ بالملخصات المطلوبة لتجميع النموذج وإحصاءات النتائج الفعالة حتى انتهاء صلاحية النصوص. إذا كنت تحتاج إلى الاحتفاظ بالنصوص على المدى الطويل، فيرجى حفظها بنفسك عند الاستدعاء.
الأعمال التحضيرية
1. إنشاء رمز الحساب
تنتمي هذه الواجهة إلى واجهة API لإدارة المنصة، ويجب استخدام Account Token (رمز الحساب):- سجّل الدخول إلى منصة AceDataCloud.
- افتح وحدة تحكم Account Token.
- انقر على «إنشاء»، واحفظ الرمز فورًا في مدير كلمات المرور أو Secret Manager.
platform.acedata.cloud/api/v1/**؛ أما استدعاء الواجهات التجارية api.acedata.cloud/** فيستخدم بيانات اعتماد API (Credential)، ولا يمكن خلط الاثنين.
2. إعداد معرّفات التصفية (اختياري)
يمكنك عرض السجلات التي يحق للحساب الحالي عرضها دون تمرير شروط تصفية. عند الحاجة إلى تضييق النطاق:application_id: احصل عليه من قائمة طلبات الخدمة؛credential_id: احصل عليه من قائمة بيانات اعتماد API؛api_id: احصل عليه من قائمة API؛service_id: احصل عليه من قائمة الخدمات.
user_id؛ وإذا تم تمريره صراحةً، فيجب أن يتطابق مع الحساب الحالي، وإلا فسيتم إرجاع 403. يمكن للمسؤولين استخدام هذه المعلمة للتصفية عبر الحسابات.
نظرة عامة على الواجهة
نطاق الاستعلام
معلمات الاستعلام
عندما يكون وقت الطلب أقدم من آخر 60 يومًا، تعيد الواجهة خطأ تحقق من الحقل
400، موضحةً أن تفاصيل الاستدعاءات الكاملة يتم الاحتفاظ بها لمدة 60 يومًا فقط.
أمثلة الطلبات
استعلم عن أحدث 100 سجل:مثال على الاستجابة
الحقول الرئيسية
تُحدد وحدة الحصة بواسطة
service.unit الخاص بـ Application المقابل، ولا ينبغي افتراض أنها دولارات.
الأخطاء وإعادة المحاولة
يُحتفظ بطلب واحد قيد التنفيذ كحد أقصى لمجموعة معلمات الاستعلام نفسها. بالنسبة للاستعلامات واسعة النطاق، استخدم أولًا نافذة يوم واحد أو أصغر، ولا تكدّس طلبات متطابقة بفاصل زمني ثابت.
الخطوة التالية
- تجميع حجم الاستدعاءات: عرض الاستخدام المجمّع حسب التاريخ وAPI.
- تصدير حجم الاستدعاءات: تنزيل عدد كبير من التفاصيل مباشرةً بصيغة CSV.
- عرض سجلات استدعاءات Proxy: الاستعلام عن سجلات الخدمات من نوع Proxy.
- عرض تفاصيل طلب الخدمة: التحقق من الرصيد ووحدة الحصة.
- تدوير بيانات اعتماد API: استبدلها فورًا عند الاشتباه في تسرّب بيانات الاعتماد.

