الانتقال إلى المحتوى الرئيسي
إرجاع Application التي يملكها الحساب أو المصرح له باستخدامها على شكل صفحات، بما في ذلك الرصيد والحالة وملخص الخدمة وبيانات الاعتماد المرتبطة. مناسب لمراقبة الأرصدة بالجملة، والعثور على Application ID، والدخول إلى إدارة بيانات الاعتماد.

الأعمال التحضيرية

  1. سجّل الدخول إلى منصة AceDataCloud.
  2. أنشئ رمز حساب في وحدة تحكم Account Token.
  3. يستخدم المستخدمون العاديون 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.

مثال على الطلب

عرض 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 وحدة الحصة.

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