الأعمال التحضيرية
- سجّل الدخول إلى منصة 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؛- القيمة الحقيقية لـ
scopeهيIndividualأوGlobal؛ - القيمة الحقيقية لـ
typeهيUsageأوPeriod.
remaining_amount فارغًا؛ يجب على العميل التحقق من عدم كونه فارغًا أولًا، ثم إجراء المقارنة الرقمية. تُحدَّد وحدة الحصة بواسطة service.unit.

