الأعمال التحضيرية
- سجّل الدخول إلى منصة AceDataCloud.
- أنشئ رمز حساب في وحدة تحكم Account Token.
- يستخدم المستخدمون العاديون
user_id=me؛ ويمكن أيضًا الحصول على UUID الخاص بهم منGET /api/v1/platform-tokens/me/.
نظرة عامة على الواجهة
يجب على المستخدمين العاديين تمرير
user_id=me. عند عدم تمريره، لا يتم تضييق الاستعلام حسب الحساب أولًا، وقد تُرجع الصفحات 403 عند مواجهة كائنات غير مصرح بها؛ وعند عدم تمريره من قبل المسؤولين يمكنهم عرض الجدول بالكامل.
معلمات الاستعلام
لا تُعد
paid وdisabled وexpired وlow_balance وtag حاليًا معلمات تصفية من جانب الخادم. ينبغي جلب القائمة أولًا لتنبيهات الرصيد، ثم الحكم من جانب العميل وفقًا لـ remaining_amount وservice.unit والحدود التجارية لكل Application.
مثال على الطلب
وصف الاستجابة
الاستجابة هي{count, items}. تحتوي كل خانة على حقول نموذج Application، بالإضافة إلى:
service:idوaliasوtitleوtypeوunitوicon_url؛credentials: ملخص بيانات الاعتماد التي يحق للمتصل الحالي رؤيتها؛paidوremaining_amountوused_amountوdisabledوallow_consume_globalوallow_overdraft؛- القيمة الفعلية لـ
scopeهيIndividualأوGlobal؛ - القيمة الفعلية لـ
typeهيUsageأوPeriod.
allow_overdraft هو حقل منطقي للقراءة فقط يتحكم فيه المسؤول، وقيمته الافتراضية false. بالنسبة للتطبيقات حسب الاستخدام (Usage) التي تم تمكين السحب على المكشوف لها، فإن الرصيد غير الكافي لا يمنع الاستدعاء، ولا يزال يتم الخصم وفقًا للاستخدام الفعلي؛ ويشير الرصيد السلبي إلى حصة بانتظار التسوية. يظل التعطيل والانتهاء وحدود بيانات اعتماد API سارية.
قد تكون remaining_amount فارغة؛ يجب على العميل التحقق من أنها ليست فارغة أولًا قبل إجراء المقارنات الرقمية. تحدد service.unit وحدة الحصة.

