المنصة › واجهة برمجة التطبيقات المنشورة
التعرضات
قرارٌ يُتخذ مرةً واحدةً، يقضي بأن تُغادر شاشةٌ واحدةٌ هذه الشركة - أيّ أعمدةٍ منها، وأيّ صفوفٍ منها، وما إذا كان يُمكن إعادة كتابة أيّ شيءٍ عليها. لا يُمكن الوصول إلى أيّ شيءٍ من الخارج حتى يُنشر هنا، ولا يوجد ما يُسمى "نشر كلّ شيء".
أين تجده؟
- الوحدة: المنصة
- المجموعة: الاتصال
- القسم: واجهة برمجة التطبيقات المنشورة
- شاشة: التعرضات
العنوان في وحدة التحكم: /platform/api-exposures
قائمة · 11 أعمدة · 16 الحقول الموجودة في نموذجها · 4 بعضها مطلوب
ما توضحه القائمة
هذه هي أعمدة القائمة، بالترتيب الذي تم رسمها به. يمكن فرز أي منها، أو تصفيتها، أو إخفاؤها، أو تصديرها.
| عمود | النوع | اسم الحقل |
|---|---|---|
| نُشر باسم | الرمز | code |
| الاسم | نص | name |
| الوحدة | الحالة | module_key |
| شاشة | الرمز | resource_key |
| الصلاحيات | الحالة | access_summary |
| الأعمدة | نص | column_summary |
| الحد الأقصى للصفوف | الرقم | max_rows |
| المفاتيح | الرقم | granted_to |
| المكالمات (30 يومًا) | الرقم | calls_30d |
| آخر من اتصل | التاريخ والوقت | last_called_at |
| الحالة | الحالة | status |
النموذج
ما المطلوب عند إنشاء سجل هنا؟ الحقول الإلزامية مُعلّمة؛ والاختيار المُختار من قائمة الإعدادات هو أحد الخيارات التي يُمكن للمسؤول إضافتها دون الحاجة إلى موافقة.
| مجال | النوع | خيارات | ملاحظات |
|---|---|---|---|
| نُشر باسم مطلوب | نص | ما يُطلق عليه العالم الخارجي هذا الاسم. إنه عنوان URL واسم أداة MCP - منفصلان عمدًا عن اسم الشاشة، لذا فإن إعادة تسمية الشاشة هنا لا تُعطل تكامل أي شخص. | |
| الاسم مطلوب | نص | ||
| ما هو | نص طويل | يقرأها المطور في وثيقة OpenAPI، ويقرأها النموذج في قائمة أدوات MCP. جدير بالذكر: إنها المكان الوحيد الذي يُذكر فيه أن كلمة "orders" هنا تعني أوامر الشراء. | |
| الوحدة مطلوب | نص | اختر من أداة الاختيار في API Studio بدلاً من الكتابة - تتم قراءة القائمة من المنتج نفسه. | |
| شاشة مطلوب | نص | ||
| يمكن قراءته | نعم أو لا | ||
| قد يتم إنشاؤه | نعم أو لا | تخضع عملية الإنشاء عبر واجهة برمجة التطبيقات (API) لنفس قواعد التحقق والترقيم والنشر التي تخضع لها عملية الإنشاء المكتوبة على الشاشة. | |
| قد يتم التغيير | نعم أو لا | ||
| قد يتم حذفها | نعم أو لا | ||
| الأعمدة | خيار | مدرج, الجميع, الكل باستثناء | القائمة — يتم إرسال ما هو مذكور أدناه فقط، ولا يتم إرسال أي شيء آخر. الكل — جميع الأعمدة. الكل باستثناء — كل شيء باستثناء ما هو مذكور أدناه. |
| أسماء الأعمدة | نص | مفصولة بفواصل. لا يتم التعامل مع أي خطأ إملائي في الاسم هنا، لذا استخدم أداة اختيار الأحرف في API Studio حيث يمكنك رؤية ما تحتويه الشاشة فعليًا. | |
| صفوف قد تنتقل | نص | نفس الفلتر الذي تستخدمه كل شاشة قائمة: {"col":"status","op":"eq","value":"posted"}. يتم تطبيقه على الخادم في كل استدعاء، ويتم تطبيق فلتر يرسله المتصل عليه باستخدام AND - لا يوجد شيء يمكنهم إرساله لتوسيعه. | |
| أكبر عدد من الصفوف لكل مكالمة | الرقم | ||
| عرض كأداة MCP | نعم أو لا | ||
| ما الذي يجب قوله لعارضة الأزياء؟ | نص طويل | يُستخدم هذا الوصف فقط في الحالات التي يحتاج فيها النموذج إلى معلومات لا يحتاجها المطور. في حال تركه فارغًا، يُستخدم الوصف المذكور أعلاه. | |
| الحالة | خيار | مسودة, نشط, معلق, متقاعد | لا يمكن الوصول إلا إلى عرض نشط. المسودة هي قرار لا يزال شخص ما يكتبه. |
القواعد التي تنطبق هنا
كل ما يظهر على هذه الشاشة يخضع لقواعد المنصة وليس لقواعد خاصة بها. إليك أهم ما يجب معرفته قبل استخدامها:
- تضييق نطاق القائمة — البحث، والشروط، والفرز، والمجاميع، والتصدير، والعروض المحفوظة.
- ما الذي يمكن تغييره — الأسباب الخمسة التي لا يجوز بموجبها تعديل السجل.
- الشركات ووحدات الأعمال — ما يفعله المحول الموجود أعلى هذه القائمة بها.
- إنشاء سجل — الحقول المطلوبة، ومصدر الخيارات، وكيفية تخصيص الرقم.
- استيراد جدول بيانات — تقبل هذه الشاشة إدخالاً واحداً، وتخضع لنفس قواعد الكتابة.