الانتقال إلى المحتوى الرئيسي
يمثّل «الطلب (Application)» علاقة اشتراك الحساب الحالي بخدمة معيّنة — يجب تقديم طلب أولاً، ثم يمكن إنشاء بيانات اعتماد API لهذا الطلب واستدعاء واجهات الأعمال. عند تقديم طلب لخدمة للمرة الأولى، سيحصل Application على قيمة free_amount المكوّنة حالياً لهذه الخدمة؛ وقد تكون هذه القيمة 0.
ℹ️ تنتمي هذه الواجهة إلى API إدارة منصة AceDataCloud، وبادئتها الموحّدة هي https://platform.acedata.cloud/api/v1/. راجع الفهرس الكامل للواجهات في الحصول على قائمة وثائق منصة AceDataCloud.

عملية التكامل الكاملة

ينتقل المستخدمون الجدد عادةً عبر هذه الخطوات الخمس من التسجيل إلى تشغيل أول واجهة أعمال:
  1. الحصول على رمز الحساب → إدارة رموز حساب منصة AceDataCloud
  2. اختيار خدمة → الحصول على قائمة خدمات منصة AceDataCloud
  3. إنشاء طلب (هذا المستند) → الحصول على الحصة الأولية وفقاً لإعدادات الخدمة
  4. إنشاء بيانات اعتماد API → إنشاء بيانات اعتماد API لمنصة AceDataCloud
  5. استدعاء واجهة الأعمال → استخدام Token المكوّن من 32 بتاً لاستدعاء https://api.acedata.cloud/<path>

نظرة عامة على الواجهة

شرح المصادقة (كيفية الحصول على رمز الحساب)

رأس الطلب:
رمز الحساب (Account Token) هو «مفتاح على مستوى الحساب» يستخدمه المطورون لإدارة موارد حساباتهم عبر API. طرق الحصول عليه:
  1. إنشاء بنقرة واحدة من وحدة التحكم (موصى به): سجّل الدخول إلى منصة AceDataCloud → وحدة تحكم Account Token → انقر «إنشاء» للحصول على رمز يبدأ بـ platform-v1-.
  2. الإنشاء عبر API: استخدم رمز حساب موجوداً أو JWT لجلسة تسجيل الدخول في المتصفح لاستدعاء POST /api/v1/platform-tokens/، راجع التفاصيل في إدارة رموز حساب منصة AceDataCloud.
⚠️ رمز الحساب حساس بقدر كلمة المرور، ويُحظر كتابته في كود الواجهة الأمامية أو المستودعات العامة. عند تسرّبه، احذفه فوراً من وحدة التحكم وأنشئ واحداً جديداً.

جسم الطلب

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

cURL

Python

Node.js

مثال على الاستجابة

نجاح (HTTP 201)

يتطابق هيكل حقول الإرجاع مع الحصول على تفاصيل طلب خدمة منصة AceDataCloud.

تم التقديم مسبقاً (HTTP 400)

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

الخدمة غير موجودة (HTTP 404)

الخدمة تتطلب مراجعة (HTTP 403)

إذا كانت قيمة need_verify=true للخدمة (يمكن رؤية هذا الحقل في قائمة الخدمات)، فيجب اتباع عملية تذكرة لتقديم طلب القائمة البيضاء.

معالجة الأخطاء

تنسيق موحد لاستجابة الخطأ:

نصائح عملية

  • الإنشاء نفسه لا يخصم رسومًا: عند الإنشاء لأول مرة، يتم تعيين الحصة الأولية وفقًا لـ free_amount الحالي للخدمة؛ قد تكون هذه القيمة 0، ولا يضمن إنشاء Application من النوع نفسه مرة أخرى منحًا متكررًا.
  • ما إذا كانت الدفعة مطلوبة يُنظر إليه من حقل paid: عند الطلب للتو يكون paid=false، ويتحول إلى true بعد استدعاء إنشاء طلب شحن منصة AceDataCloud لإتمام الدفع.
  • disabled=true يعني أنه معطل مؤقتًا—مثل تفعيل التحكم بالمخاطر أو المتأخرات وغيرها. عند التعطيل، ستعيد واجهة الأعمال 403.
  • لا تُنشئ بشكل متوازٍ دون حدود: احصل أولًا على service_id المستهدف من قائمة الخدمات المقسمة إلى صفحات، ثم قدّم الطلبات عنصرًا تلو الآخر حسب احتياجات العمل؛ عند مواجهة duplication أعد استخدام Application الموجود.

الواجهات ذات الصلة

allow_overdraft معطل افتراضيًا، ويُفوّض بشكل منفصل من قبل المسؤول؛ لا يمكن تفعيله ذاتيًا عبر معلمات الطلب عند إنشاء Application.