التحضيرات
- سجّل الدخول إلى منصة AceDataCloud.
- أنشئ رمز حساب في وحدة تحكم Account Token، واحفظه فورًا في مدير كلمات المرور أو Secret Manager.
- احصل عند الحاجة على معرّفات التصفية من قائمة طلبات الخدمة، أو قائمة بيانات اعتماد API، أو قائمة API.
نظرة عامة على الواجهة
تُرجع هذه الواجهة CSV بشكل متدفق ومتزامن، ولا تنشئ مهمة تصدير، ولا تُرجع JSON أو رابط تنزيل. فقط عندما لا يتم توفير وقت البداية والنهاية معًا، يتم افتراضيًا تصدير السجلات من بداية الشهر التقويمي الحالي حتى الوقت الحالي؛ وعند توفير حد واحد فقط، لن يُستكمل الحد الآخر تلقائيًا بحدود هذا الشهر.
معاملات الاستعلام
يقتصر نطاق التصدير دائمًا على السجلات المرئية للحساب الحالي باعتباره جهة الدفع و/أو المستدعي الفعلي، ولا يدعم التصدير عبر الحسابات.
أمثلة الطلبات
احفظ CSV للشهر الحالي مباشرةً:أعمدة CSV
ترتيب رأس CSV ثابت كما يلي:
تُحدَّد وحدة الرصيد بواسطة
service.unit الخاص بـ Application المقابل.
تحديد ما إذا كان التصدير مكتملًا
يتم إخراج ما يصل إلى 1,000,000 سجل في المرة الواحدة. بعد أن يبدأ الخادم في إرجاع CSV، لا يمكنه تغيير الخطأ أثناء العملية إلى حالة HTTP أخرى، لذا يجب على العميل التحقق من السطر الأخير:# truncated:: تم الوصول إلى حد عدد الصفوف؛ صدّر على دفعات باستخدام نوافذ زمنية أصغر.# error:: انقطعت القراءة المتدفقة؛ أعد التصدير بعد تقليص النطاق.
الأخطاء وإعادة المحاولة
الخطوة التالية
- عرض سجلات الاستدعاء: التصفية عبر الإنترنت وتحديد طلب واحد.
- تجميع حجم الاستدعاءات: عرض البيانات المجمعة حسب التاريخ أو API أو النموذج.
- عرض تفاصيل طلب الخدمة: التحقق من وحدة الرصيد والرصيد المتبقي.

