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

