ℹ️ تنتمي هذه الواجهة إلى واجهة API لإدارة منصة AceDataCloud، وبادئتها الموحدة هي https://platform.acedata.cloud/api/v1/. انظر فهرس الواجهات الكامل في الحصول على قائمة وثائق منصة AceDataCloud.
رمز الحساب مقابل بيانات اعتماد API
هذان النوعان من المفاتيح هما الأكثر إرباكًا للمبتدئين، يُرجى التمييز بينهما أولًا:
إذا كنت تريد فقط استدعاء GPT-4.1، فأنت تحتاج إلى بيانات اعتماد API، وليس رمز حساب.
إذا كنت تريد كتابة نص برمجي مؤتمت لإدارة الشحن، أو عرض الفواتير الشهرية، أو توزيع بيانات الاعتماد بالجملة على أعضاء الفريق، فعندها فقط تستخدم رمز الحساب.
الإنشاء بنقرة واحدة في وحدة التحكم (موصى به)
- سجّل الدخول إلى https://platform.acedata.cloud.
- انتقل إلى الشريط الجانبي → «المطور» → «Account Token».
- انقر زر «إنشاء» في أعلى اليسار، لتحصل فورًا على رمز
platform-v1-...، انقر زر النسخ واحفظه في مدير كلمات المرور.
⚠️ حاليًا، تُرجع استجابات الإنشاء والقائمة والتفاصيل جميعها النص الصريح للرمز. يُرجى التعامل مع الاستجابة بأكملها باعتبارها سرًا، ولا تكتبها في السجلات أو منصات التحليل أو التخزين الدائم للواجهة الأمامية؛ ويجب ألا يعتمد العميل أيضًا على استمرار إرجاع النص الصريح في القوائم على المدى الطويل.
إنشاء رمز حساب باستخدام API
نظرة عامة على الواجهة
توضيح المصادقة (مشكلة البيضة والدجاجة)
كيف تحصل على الرمز الأول؟ الإجابة هي عبر وحدة التحكم — بعد تسجيل الدخول في المتصفح، تستخدم وحدة التحكم مصادقة JWT لاستدعاءتنسيق رأس الطلب:POST /platform-tokens/، وتمنحك الرمز الأول. بعد ذلك، يمكنك استخدام أي رمزplatform-v1-...موجود لإنشاء المزيد.
مثال الطلب
الاستجابة (HTTP 201)
وصف الحقول
الحصول على قائمة رموز الحساب
نظرة عامة على الواجهة
معلمة الاستعلام الإلزامية
⚠️ يجب تضمينكيفية الحصول على?user_id=<your_user_id>. السبب: تُجري واجهة القائمة تحققًا من الصلاحيات لكل كائن في نتائج الترقيم الصفحي، وعند عدم تضمينuser_id، سيُرفض أول كائن لا ينتمي إليك وتُعاد403 permission_denied.
user_id:
- افتح https://auth.acedata.cloud/user/profile في المتصفح، حيث يظهر UUID الكامل في أعلى الصفحة.
- أو أعد تعبئة حقل
user_idمباشرةً من القيمة المرجعة بواسطةPOST /platform-tokens/.
معلمات الاستعلام
مثال الطلب
الاستجابة (HTTP 200)
تستخدم استجابة الترقيم لهذه الواجهةcount+items. قد تستخدم واجهات المنصة الأخرى بنية مختلفة، لذا يُرجى الرجوع إلى الوثائق المقابلة والاستجابة الفعلية.
الحصول على تفاصيل رمز الحساب
HTTP 200.
حذف رمز الحساب
- عند النجاح يتم إرجاع
HTTP 204 No Content، دون جسم استجابة. - بعد الحذف يصبح الرمز غير صالح فورًا، وستتلقى جميع الخدمات التي تستخدمه حاليًا
401مباشرةً. - سيؤدي الاستعلام عن هذا
idمرة أخرى إلى إرجاع404.
⚠️ الحذف غير قابل للعكس. إذا كنت تشك في تسرب الرمز، يمكنك إنشاء رمز جديد أولاً، وتحويل جانب الأعمال إليه، ثم حذف الرمز القديم.
العمليات غير المدعومة
مرجع سريع لرموز الخطأ
تنسيق استجابة الخطأ موحد:
trace_id لخدمة العملاء أو ألصقه في تذكرة الدعم، لتحديد السجلات بسرعة.
مثال كامل للكود
Python
Node.js
الاستخدام في واجهات API الأخرى للمنصة
ضعplatform-v1-... مباشرةً في ترويسة Authorization: Bearer ... لاستدعاء أي واجهة منصة تتطلب المصادقة:
يختلف تمامًا عن بيانات اعتماد API السداسية العشرية المكونة من 32 رقمًا المستخدمة في واجهات الأعمالhttps://api.acedata.cloud/**(مثل OpenAI وMidjourney وSuno وVeo وغيرها). لا تخلط بينهما — ستؤدي كتابة رمز الحساب في واجهة الأعمال إلى401، والعكس صحيح.
الواجهات ذات الصلة
- الحصول على قائمة طلبات خدمات منصة AceDataCloud — استخدام رمز الحساب لمعرفة الخدمات التي تقدمت بطلبها
- إنشاء بيانات اعتماد API لمنصة AceDataCloud — استخدام رمز الحساب لإصدار بيانات اعتماد مكوّنة من 32 خانة لاستخدام API الخاص بالأعمال
- الحصول على سجلات استدعاءات API لمنصة AceDataCloud — لمراجعة الحسابات واستكشاف الأخطاء وإصلاحها
- الحصول على قائمة طلبات منصة AceDataCloud — لمراجعة سجل إعادة الشحن

