free_amount المكوّنة حالياً لهذه الخدمة؛ وقد تكون هذه القيمة 0.
ℹ️ تنتمي هذه الواجهة إلى API إدارة منصة AceDataCloud، وبادئتها الموحّدة هي https://platform.acedata.cloud/api/v1/. راجع الفهرس الكامل للواجهات في الحصول على قائمة وثائق منصة AceDataCloud.
عملية التكامل الكاملة
ينتقل المستخدمون الجدد عادةً عبر هذه الخطوات الخمس من التسجيل إلى تشغيل أول واجهة أعمال:- الحصول على رمز الحساب → إدارة رموز حساب منصة AceDataCloud
- اختيار خدمة → الحصول على قائمة خدمات منصة AceDataCloud
- إنشاء طلب (هذا المستند) → الحصول على الحصة الأولية وفقاً لإعدادات الخدمة
- إنشاء بيانات اعتماد API → إنشاء بيانات اعتماد API لمنصة AceDataCloud
- استدعاء واجهة الأعمال → استخدام Token المكوّن من 32 بتاً لاستدعاء
https://api.acedata.cloud/<path>
نظرة عامة على الواجهة
شرح المصادقة (كيفية الحصول على رمز الحساب)
رأس الطلب:- إنشاء بنقرة واحدة من وحدة التحكم (موصى به): سجّل الدخول إلى منصة AceDataCloud → وحدة تحكم Account Token → انقر «إنشاء» للحصول على رمز يبدأ بـ
platform-v1-. - الإنشاء عبر API: استخدم رمز حساب موجوداً أو JWT لجلسة تسجيل الدخول في المتصفح لاستدعاء
POST /api/v1/platform-tokens/، راجع التفاصيل في إدارة رموز حساب منصة AceDataCloud.
⚠️ رمز الحساب حساس بقدر كلمة المرور، ويُحظر كتابته في كود الواجهة الأمامية أو المستودعات العامة. عند تسرّبه، احذفه فوراً من وحدة التحكم وأنشئ واحداً جديداً.
جسم الطلب
مثال على الطلب
cURL
Python
Node.js
مثال على الاستجابة
نجاح (HTTP 201)
تم التقديم مسبقاً (HTTP 400)
الخدمة غير موجودة (HTTP 404)
الخدمة تتطلب مراجعة (HTTP 403)
need_verify=true للخدمة (يمكن رؤية هذا الحقل في قائمة الخدمات)، فيجب اتباع عملية تذكرة لتقديم طلب القائمة البيضاء.
معالجة الأخطاء
تنسيق موحد لاستجابة الخطأ:
نصائح عملية
- الإنشاء نفسه لا يخصم رسومًا: عند الإنشاء لأول مرة، يتم تعيين الحصة الأولية وفقًا لـ
free_amountالحالي للخدمة؛ قد تكون هذه القيمة 0، ولا يضمن إنشاء Application من النوع نفسه مرة أخرى منحًا متكررًا. - ما إذا كانت الدفعة مطلوبة يُنظر إليه من حقل
paid: عند الطلب للتو يكونpaid=false، ويتحول إلىtrueبعد استدعاء إنشاء طلب شحن منصة AceDataCloud لإتمام الدفع. disabled=trueيعني أنه معطل مؤقتًا—مثل تفعيل التحكم بالمخاطر أو المتأخرات وغيرها. عند التعطيل، ستعيد واجهة الأعمال403.- لا تُنشئ بشكل متوازٍ دون حدود: احصل أولًا على
service_idالمستهدف من قائمة الخدمات المقسمة إلى صفحات، ثم قدّم الطلبات عنصرًا تلو الآخر حسب احتياجات العمل؛ عند مواجهةduplicationأعد استخدام Application الموجود.
الواجهات ذات الصلة
- الحصول على قائمة خدمات منصة AceDataCloud — اختر الخدمة أولًا
- الحصول على قائمة طلبات خدمات منصة AceDataCloud — عرض جميع الطلبات المقدمة
- الحصول على تفاصيل طلب خدمة منصة AceDataCloud — عرض طلب واحد
- إنشاء بيانات اعتماد API لمنصة AceDataCloud — الخطوة التالية بعد نجاح الطلب
- إنشاء طلب شحن لمنصة AceDataCloud — الشحن بعد نفاد الحصة المجانية
allow_overdraft معطل افتراضيًا، ويُفوّض بشكل منفصل من قبل المسؤول؛ لا يمكن تفعيله ذاتيًا عبر معلمات الطلب عند إنشاء Application.
