السماح لبرامج أخرى بقراءة بياناتك

استوديو واجهة برمجة التطبيقات: نشر شاشة واحدة في كل مرة، وإصدار مفتاح، وتثبيته على عنوان، ونفس النشر كخادم MCP لوكيل الذكاء الاصطناعي.

عاجلاً أم آجلاً، سيحتاج طرف خارجي من TRANXACT إلى بياناتك: أداة إعداد تقارير، أو نظام شريك، أو موقع إلكتروني يحتاج إلى قائمة الأسعار، أو وكيل ذكاء اصطناعي طُرح عليه سؤال حول نشاطك التجاري. في "استوديو واجهة برمجة التطبيقات" (API Studio) ضمن "المنصة"، يمكنك تحديد ما يُسمح لك بالوصول إليه - شاشة تلو الأخرى، وعمود تلو الآخر.

لا يمكن الوصول إلى أي شيء من الخارج حتى يقوم أحدهم بنشره. لا يوجد إعداد يتيح الوصول إلى كل شيء، ولا يوجد مفتاح يتيح الوصول إلى كل شيء. لا يحتوي أي تطبيق جديد على واجهة برمجة تطبيقات (API) على الإطلاق، وهذه هي نقطة البداية الصحيحة، وليست شيئًا ينتظر تفعيله.

القرارات الأربعة، بالترتيب

ماذا	ما يقرره	من يصنعه عادةً؟
التعرض	قد تغادر تلك الشاشة الشركة على الإطلاق - أي أعمدة منها، وأي صفوف منها، وما إذا كان من الممكن إعادة كتابة أي شيء عليها.	أياً كان مالك البيانات
عميل	يوجد هذا البرنامج، وما اسمه، ومن يجب الاتصال به بشأنه، وأي مستخدم من مستخدميك يعمل البرنامج لصالحه.	أياً كان من يدير عملية التكامل
منحة	قد يصل هذا العميل إلى هذا المستوى من الظهور، باستخدام هذه الأفعال.	أياً كان من يدير عملية التكامل
عنوان مسموح به	من أين يمكن تقديم المفتاح - من أصل المتصفح، أو المضيف، أو عنوان خادم واحد، أو الشبكة.	أياً كان من يدير عملية التكامل

توفر المنصة ثلاثة أدوار لهذا الغرض، وتفصل بينها عمدًا. يحدد ناشر واجهة برمجة التطبيقات (API) ما يُسمح بتصديره، ولا يملك صلاحية إصدار مفتاح. يصدر مسجل واجهة برمجة التطبيقات (API) المفاتيح، ولا يملك صلاحية إنشاء أي واجهة. يقرأ مراجع واجهة برمجة التطبيقات (API) جميع البيانات دون إجراء أي تغييرات. إن قيام شخص واحد بنشر جدول الرواتب وإصدار مفتاح خاص به لقراءته، يُشكل مسار تصدير كاملًا وغير موثق، حيث تبدو كل خطوة فيه كتغيير إداري عادي.

نشر شاشة

افتح المنصة ← استوديو واجهة برمجة التطبيقات واختر شاشة. القائمة تحتوي على جميع الشاشات الموجودة في وحدة التحكم، والتي يتم قراءتها من المنتج نفسه - لذا فإن الشاشة التي تم إصدارها في هذا الإصدار موجودة فيها.
حدد الأعمدة التي قد تُحذف. لا يتم إرسال أي شيء غير محدد: لا في قائمة، ولا في سجل منفرد، ولا في البيانات المُعادة من عملية الكتابة. لا يتم تحديد أي شيء في البداية، عن قصد.
حدد الأفعال. خاصية القراءة مُفعّلة افتراضياً؛ أما الإنشاء والتغيير والحذف فهي قرارات منفصلة، لأن السماح لنظامهم بقراءة بياناتك الرئيسية والسماح له بحذفها ليسا جملة واحدة.
يمكنك اختيارياً تقييد الصفوف - فقط الفواتير المنشورة، وهذا العام فقط. هذا هو نفس الفلتر الذي يظهر في كل شاشة قائمة، ويتم تطبيقه على الخادم في كل مكالمة، ولا يمكن لأي شيء يرسله المتصل توسيعه.
احتفظ به. إنه مجرد مسودة، والمسودة لا تُجدي نفعاً. اجعله حقيقة واقعة عندما تُريد ذلك حقاً.
اضغط على زر المعاينة قبل إعطاء أي شخص مفتاحًا. سيوضح لك ذلك بالضبط ما سيحصل عليه الشريك، وعدد الأعمدة التي تم حجبها.

تسجيل البرنامج

العميل هو سجل لبرنامج ما: اسمه، ووظيفته، ومن يمكن التواصل معه بشأنه، والأهم من ذلك، أي مستخدم من مستخدميك يُمثّله. كل مكالمة يُجريها المفتاح تتم باسم ذلك المستخدم. ما لا يستطيع المستخدم فعله، قد لا يستطيع المفتاح فعله أيضًا.

هذا هو الحقل الأهم على الشاشة، ولذلك فإن أي تعريض لا يُؤدي إلا إلى تضييق نطاق الوصول، وليس توسيعه. وجّه المفتاح إلى مستخدم مُخصّص لهذا الغرض، يحمل الدور الأضيق الذي يُنجز المهمة - وليس إلى مدير النظام الحقيقي لمجرد سهولة ذلك.

يُعرض المفتاح مرة واحدة فقط عند إصداره، ولا يُعرض بعدها. إصدار مفتاح جديد يُوقف عمل المفتاح القديم فورًا. يمكن سحب المفتاح دون حذف العميل، لذا يبقى السجل مُبيّنًا لمن كان يملك صلاحية الوصول ومتى سُحبت منه.

المكان الذي يمكن استخدام المفتاح منه

مفتاح بدون عناوين مسموح بها لا يُوصل إلى أي شيء. عدم وجود عناوين مُسماة يُعتبر غير قابل للوصول حاليًا، ولن يكون قابلًا للوصول من أي مكان، لأن مفتاحًا مُسرّبًا يعمل من أي حاسوب محمول في العالم يُمثل كامل المخاطرة. أربعة أنواع من المدخلات: مصدر المتصفح، أو المضيف المُحيل، أو عنوان واحد، أو شبكة بصيغة CIDR.

يمكن تصنيف العميل على أنه قابل للاستخدام من أي مكان، وأحيانًا يكون هذا صحيحًا - شريك يتغير عنوان خروجه بالفعل. إنه تغيير مقصود مصحوب بتحذير وليس الوضع الافتراضي.

ما الذي يجب إرساله إلى الشخص المسؤول عن عملية الدمج؟

يقوم الاستوديو بطباعة العناوين الأربعة. العنوان الأساسي هو /api/v1، ويتم وضع المفتاح في ترويسة Authorization: Bearer، ويسرد /api/v1/resources ما يمكن لهذا المفتاح الوصول إليه، و /api/v1/openapi.json هو نفسه مستند OpenAPI 3.1.

يتم توليد كليهما من المفتاح الذي يطلبهما. لا يُسلّم الشريك أبدًا مستندًا يسرد أربعين نقطة نهاية لا يمكنه الاتصال بها: يصف مستنده تحديدًا ما يمكنه الاتصال به فقط، ولا يمكنه وصف مسار سيتم رفضه، لأنه مبني من نفس الصفوف التي يتحقق منها معالج الطلبات.

نفس البيانات لوكيل الذكاء الاصطناعي

العنوان /api/v1/mcp هو خادم بروتوكول سياق النموذج. يُمنح الوكيل المتصل به أداةً لكل وظيفة يُمكن للمفتاح القيام بها، ولا شيء غير ذلك - لا توجد أداة للبيانات التي لم ينشرها أحد، ولا أداة لفعل لم يُمنحه أحد. إنه نفس المنشور، موصوف للنموذج وليس للمطور، لذا لا يمكن أن يختلفا أبدًا.

اكتب تعليمات MCP على جهاز العميل. إنه المكان الوحيد الذي يتم فيه إخبار النموذج بأن هذه الأدوات تصل إلى سجل فعلي وليس إلى بيئة تجريبية، والمكان الوحيد الذي يمكنك فيه تحديد أن "الأوامر" هنا تعني أوامر الشراء وليس أوامر البيع.

ما يحدث في كل مكالمة

لا يُعدّ نشر طلب وصول إلى قاعدة البيانات اختصارًا لها. بل يتم التحقق من هوية المستخدم، ومطابقته مع بيانات الوصول والصلاحيات الممنوحة، ثم يُنفّذ الطلب بصلاحيات المستخدم الخاص بك عبر واجهة برمجة التطبيقات (API) الخاصة بالمنصة - وهي نفس الطريقة التي تستخدمها وحدة التحكم. ينطبق نطاق الشركة، ونطاق وحدة الأعمال، وقيود المواقع، وفترات الإغلاق، وقواعد النشر، والحقول المخصصة، والمنطق المخصص، وإمكانية التعديل، وسجل التدقيق، لأنها جميعًا تُنفّذ بنفس الكود.

يتم تسجيل كل مكالمة، سواء بالموافقة أو الرفض، مع ذكر السبب. يوجد هذا السجل ضمن Platform → API Studio → API Call Log، ويُعدّ المفتاح المُقدّم من عنوان لم يسمح به أحد هو السطر الأكثر إثارة للاهتمام الذي ينتجه.

عندما لا ينجح الأمر

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

تُظهر قائمة العملاء عمودًا للجاهزية بدلًا من الحالة فقط، لأن العميل قد يكون نشطًا، ويملك مفتاحًا، ومع ذلك لا يستطيع الوصول إلى أي شيء - لا يوجد مستخدم لتشغيله، ولا عنوان مسموح به، ولا شيء مُصرّح به. هكذا يمضي وقت الظهيرة في قراءة حالة "نشط" بينما تُرفض جميع المكالمات.