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

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