Skip to main content
رمز الحساب (Account Token، المعروف سابقًا باسم Platform Token) هو “مفتاح على مستوى الحساب” للمطورين لإدارة موارد منصة AceDataCloud برمجيًا (طلبات الخدمات، بيانات اعتماد API، الطلبات، سجلات الاستدعاء، الرصيد، الملفات، إلخ). يشبه دوره رمز المستخدم بعد تسجيل الدخول من الواجهة الأمامية، ولا يملك وقت انتهاء افتراضيًا؛ يمكن للمستخدمين العاديين إدارة رموزهم فقط، بينما يمكن للمسؤولين المتميزين إدارة رموز حسابات أخرى وفقًا للصلاحيات. يصل رمز الحساب إلى واجهات المنصة باستخدام الصلاحيات الحالية للحساب التابع له: تسري الصلاحيات الأساسية والصلاحيات الممنوحة مباشرةً وصلاحيات مجموعة المستخدمين التابع لها مجتمعةً؛ بعد الانضمام إلى مجموعة أو الإزالة منها، يُحكم وفقًا للصلاحيات الجديدة في الطلب التالي مباشرةً. لا يزال الوصول إلى موارد محددة مثل الطلبات والطلبات الشرائية يتطلب التحقق من الملكية. لا تنتهي صلاحية رموز الحساب افتراضيًا، لذا يُرجى استخدامها فقط في بيئات موثوقة وحفظها بعناية.
ℹ️ تنتمي هذه الواجهة إلى واجهة API لإدارة منصة AceDataCloud، وبادئتها الموحدة هي https://platform.acedata.cloud/api/v1/. انظر فهرس الواجهات الكامل في الحصول على قائمة وثائق منصة AceDataCloud.

رمز الحساب مقابل بيانات اعتماد API

هذان النوعان من المفاتيح هما الأكثر إرباكًا للمبتدئين، يُرجى التمييز بينهما أولًا: إذا كنت تريد فقط استدعاء GPT-4.1، فأنت تحتاج إلى بيانات اعتماد API، وليس رمز حساب. إذا كنت تريد كتابة نص برمجي مؤتمت لإدارة الشحن، أو عرض الفواتير الشهرية، أو توزيع بيانات الاعتماد بالجملة على أعضاء الفريق، فعندها فقط تستخدم رمز الحساب.

الإنشاء بنقرة واحدة في وحدة التحكم (موصى به)

  1. سجّل الدخول إلى https://platform.acedata.cloud.
  2. انتقل إلى الشريط الجانبي → «المطور» → «Account Token».
  3. انقر زر «إنشاء» في أعلى اليسار، لتحصل فورًا على رمز platform-v1-...، انقر زر النسخ واحفظه في مدير كلمات المرور.
وحدة تحكم Account Token
⚠️ حاليًا، تُرجع استجابات الإنشاء والقائمة والتفاصيل جميعها النص الصريح للرمز. يُرجى التعامل مع الاستجابة بأكملها باعتبارها سرًا، ولا تكتبها في السجلات أو منصات التحليل أو التخزين الدائم للواجهة الأمامية؛ ويجب ألا يعتمد العميل أيضًا على استمرار إرجاع النص الصريح في القوائم على المدى الطويل.

إنشاء رمز حساب باستخدام API

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

توضيح المصادقة (مشكلة البيضة والدجاجة)

كيف تحصل على الرمز الأول؟ الإجابة هي عبر وحدة التحكم — بعد تسجيل الدخول في المتصفح، تستخدم وحدة التحكم مصادقة JWT لاستدعاء POST /platform-tokens/، وتمنحك الرمز الأول. بعد ذلك، يمكنك استخدام أي رمز platform-v1-... موجود لإنشاء المزيد.
تنسيق رأس الطلب:

مثال الطلب

الاستجابة (HTTP 201)

وصف الحقول


الحصول على قائمة رموز الحساب

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

معلمة الاستعلام الإلزامية

⚠️ يجب تضمين ?user_id=<your_user_id>. السبب: تُجري واجهة القائمة تحققًا من الصلاحيات لكل كائن في نتائج الترقيم الصفحي، وعند عدم تضمين user_id، سيُرفض أول كائن لا ينتمي إليك وتُعاد 403 permission_denied.
كيفية الحصول على user_id:
  1. افتح https://auth.acedata.cloud/user/profile في المتصفح، حيث يظهر UUID الكامل في أعلى الصفحة.
  2. أو أعد تعبئة حقل 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، والعكس صحيح.

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