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

التحضيرات

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

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

تُرجع هذه الواجهة CSV بشكل متدفق ومتزامن، ولا تنشئ مهمة تصدير، ولا تُرجع JSON أو رابط تنزيل. فقط عندما لا يتم توفير وقت البداية والنهاية معًا، يتم افتراضيًا تصدير السجلات من بداية الشهر التقويمي الحالي حتى الوقت الحالي؛ وعند توفير حد واحد فقط، لن يُستكمل الحد الآخر تلقائيًا بحدود هذا الشهر.

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

يقتصر نطاق التصدير دائمًا على السجلات المرئية للحساب الحالي باعتباره جهة الدفع و/أو المستدعي الفعلي، ولا يدعم التصدير عبر الحسابات.

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

احفظ CSV للشهر الحالي مباشرةً:
التصدير حسب Application والوقت ورمز الحالة:
الحفظ المتدفق في Python والتحقق من الاكتمال:

أعمدة CSV

ترتيب رأس CSV ثابت كما يلي:
تُحدَّد وحدة الرصيد بواسطة service.unit الخاص بـ Application المقابل.

تحديد ما إذا كان التصدير مكتملًا

يتم إخراج ما يصل إلى 1,000,000 سجل في المرة الواحدة. بعد أن يبدأ الخادم في إرجاع CSV، لا يمكنه تغيير الخطأ أثناء العملية إلى حالة HTTP أخرى، لذا يجب على العميل التحقق من السطر الأخير:
  • # truncated:: تم الوصول إلى حد عدد الصفوف؛ صدّر على دفعات باستخدام نوافذ زمنية أصغر.
  • # error:: انقطعت القراءة المتدفقة؛ أعد التصدير بعد تقليص النطاق.
يجب على برنامج المطابقة اعتبار الملف غير مكتمل عند رؤية أي marker، ولا يجوز تسجيله بصمت.

الأخطاء وإعادة المحاولة

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