Skip to main content
يمثل «الطلب (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 الموجود.

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