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

التحضير

  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، ولا يجوز تسجيله بصمت.

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

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