Skip to main content
احصل على المعلومات الكاملة لنقطة نهاية API واحدة عبر معرّف API — إضافةً إلى حقول definition ‏(مخطط OpenAPI 3.0)، وservice ‏(تفاصيل الخدمة التابعة)، وproducts ‏(المنتجات المرتبطة) مقارنةً بـواجهة القائمة. مناسب لسيناريوهات مثل إنشاء SDK تلقائيًا، وتغذية LLM Agent بوصف الأدوات، والعرض الديناميكي لمواقع الوثائق.
ℹ️ تنتمي هذه الواجهة إلى واجهة API لإدارة منصة AceDataCloud، وبادئة موحّدة هي https://platform.acedata.cloud/api/v1/. راجع الحصول على قائمة وثائق منصة AceDataCloud لفهرس الواجهات الكامل.

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

كلٌّ من /apis/{id} و/apis/{id}/ متاحان حاليًا؛ تستخدم الأمثلة بشكل موحّد صيغة بدون شرطة مائلة لاحقة.

شرح المصادقة

هذه الواجهة عامة بالكامل، ولا تتطلب رمز حساب أو حالة تسجيل دخول.

معاملات المسار

أمثلة الطلبات

cURL

Python

Node.js

مثال الاستجابة (HTTP 200)

شرح حقول الاستجابة

تتضمن واجهة التفاصيل، بالإضافة إلى حقول واجهة القائمة، ما يلي:

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

نصائح عملية

  • حقل definition كبير جدًا: قد يحتوي مخطط OpenAPI الخاص بواجهة API واحدة على مئات أسطر JSON. إذا كنت تحتاج فقط إلى فهرس الخدمات ولا تحتاج إلى المخطط، فيجب استخدام واجهة القائمة بدلًا من ذلك.
  • الاستخدام الشائع لإنشاء SDK:
  • تتبع تغييرات API: حقل updated_at هو وقت آخر تغيير للمخطط. يتيح الاشتراك في هذا الحقل إعادة إنشاء SDK تلقائيًا عند تغيّر OpenAPI.

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