API-first architecture
Concept
تصميم البنية القائمة على واجهات برمجة التطبيقات أولاً يصمم القدرات التجارية كواجهات برمجة تطبيقات مستقرة وقابلة للاستدعاء قبل أي واجهة مستخدم، بحيث تستهلك واجهات المستخدم ومحركات سير العمل ووكلاء الذكاء الاصطناعي العمليات نفسها.
مواضيع تُناقش أيضًا
في الحلقة التي تتناول API-first architecture تُناقش أيضًا: Computer-Using Agent (CUA)، Foundry Agent Service، Service account، Agent observability، Microsoft Agent 365 وSoftware as a service (SaaS).
Description
البنية القائمة على واجهات برمجة التطبيقات أولاً هي نهج تصميمي تُعرَّف فيه القدرات التجارية كواجهات برمجة تطبيقات مستقرة وقابلة للاستدعاء قبل بناء أي واجهة مستخدم. ثم تستهلك واجهات المستخدم ومحركات سير العمل ووكلاء الذكاء الاصطناعي العمليات نفسها، بدلاً من أن يصل كل عميل إلى المنطق عبر مساره الخاص. في هذا النموذج تُعامَل واجهة البرمجة بوصفها قراراً منتجياً لا منتجاً ثانوياً للشيفرة، إذ من المتوقع أن يبني عليها المطورون الخارجيون والشركاء ووكلاء الذكاء الاصطناعي.
وعنصر أساسي في تطوير واجهات البرمجة أولاً هو عقد واجهة البرمجة. وفقاً لمقالة Microsoft حول التطوير القائم على واجهات البرمجة أولاً، يصف العقد نقاط النهاية وبيانات الطلب والاستجابة والأخطاء المتوقعة، ويُكتب قبل التنفيذ أو واجهة المستخدم. ويُعبَّر عن العقد عادةً بصيغة يمكن للآلة قراءتها، وغالباً OpenAPI. وبعد اعتماد العقد تنفذه فرق الواجهات الخلفية، بينما تبني فرق الواجهات الأمامية وتطبيقات الهاتف عملها على نماذج محاكاة تُولَّد منه. ويمكن توليد الوثائق وحزم تطوير البرمجيات والاختبارات من المصدر نفسه، ما يحافظ على اتساق هذه المخرجات مع بعضها.
ويُقارَن هذا النهج عادةً بالتطوير القائم على الشيفرة أولاً. ففي هذا الإعداد تنشأ واجهة البرمجة من الشيفرة الموجودة، وقد يؤدي ذلك إلى تسريب تفاصيل داخلية إلى الواجهة العامة. أما واجهات البرمجة أولاً فتعكس الترتيب: تُصمَّم الواجهة عن قصد، ثم تُكتب الشيفرة لتلبية متطلباتها. وتشير صفحة Microsoft أيضاً إلى المفاضلات، فالعمل القائم على العقد يضيف جهد مراجعة مسبقاً، وقد يكون النهج القائم على الشيفرة أولاً معقولاً لأداة داخلية مبكرة يكون مستهلكوها قليلين ومن المتوقع أن تتغير واجهتها بسرعة. والصفحة مقالة ترويجية لمورّد وتتضمن محتوى خاصاً بـ Azure.
ويُعد الإصدار جزءاً مهماً من هذه الممارسة. فلأن المستهلكين يعتمدون على العقد، يُعامَل الإصدار بوصفه اتفاقاً معهم: تُعدّ التغييرات الإضافية آمنة داخل الإصدار الواحد، بينما تتطلب التغييرات الكاسرة إصداراً جديداً. ويمكن الإعلان عن إيقاف الإصدارات القديمة عبر ترويسة Sunset، ما يمنح المستهلكين مساراً محدداً للانتقال بدلاً من تعطل مفاجئ.
وخاصية إضافية هي أن واجهة برمجة واحدة يمكنها خدمة عملاء الويب والهاتف والشركاء والوكلاء خلف بوابة واحدة. عندها تُطبَّق المصادقة وتحديد المعدل على جميع المستدعين بشكل موحد، ولا يُكرَّر منطق الأعمال عبر قنوات منفصلة. وهذا ما يجعل المفهوم ذا صلة بالأنظمة المدفوعة بالوكلاء، حيث تحتاج برامج الوكلاء إلى عمليات موثوقة وموثقة يمكنها استدعاؤها.
ويربط حلقة M365.FM بعنوان "Computer-Using Agents: How CUA Could Transform SaaS" بين البنية القائمة على واجهات برمجة التطبيقات أولاً وأنظمة الوكلاء. تقول الحلقة إن أنظمة الوكلاء تزدهر عند تبني بنية قائمة على واجهات برمجة التطبيقات أولاً، لأنها تتيح ربط الوكلاء والأنظمة وسير العمل بوضوح وقابلية للتنبؤ. وتصف واجهات البرمجة المستقرة بأنها العمود الفقري للأنظمة الذكية، وتقول إن المطورين يمكنهم الاعتماد عليها للابتكار دون خوف من الانقطاعات. كما تشير إلى قابلية التوسع بوصفها فائدة تساعد المؤسسات على التكيف مع المتطلبات المتغيرة. وفي هذا الإطار يتزامن تصميم واجهات البرمجة أولاً مع الاستثمار في سير العمل الذي يستطيع الوكلاء إنشاءه وأتمتته وتوسيع نطاقه.
ومن القرارات المعتادة حول البنية القائمة على واجهات برمجة التطبيقات أولاً: أي القدرات تُعرض كواجهات برمجة تطبيقات، وأي صيغة عقد تُستخدم، وكيفية إصدار التغييرات وإيقاف الإصدارات القديمة، وأين توضع البوابة للمصادقة المشتركة وتحديد المعدل. كما توازن الفرق بين التكلفة المسبقة لمراجعة العقد والفوائد المتمثلة في العمل المتوازي بين الواجهة الأمامية والخلفية وفي الوثائق والاختبارات المولَّدة.
Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.
| Type | Concept |
|---|---|
| Kind | Architecture |
Frequently asked questions
Questions marked with AI were written with AI from the facts on this page.
ما المقصود بالبنية القائمة على واجهات برمجة التطبيقات أولاً؟ (AI)
يعني تصميم القدرات التجارية كواجهات برمجة تطبيقات مستقرة وقابلة للاستدعاء قبل أي واجهة مستخدم، بحيث تستهلك واجهات المستخدم ومحركات سير العمل ووكلاء الذكاء الاصطناعي العمليات نفسها. يُعرَّف عقد الواجهة أولاً ثم يأتي التنفيذ.
كيف يختلف النهج القائم على واجهات البرمجة أولاً عن النهج القائم على الشيفرة أولاً؟ (AI)
في التطوير القائم على الشيفرة أولاً تكون واجهة البرمجة نتاجاً ثانوياً للشيفرة الموجودة وقد تكشف تفاصيل داخلية. أما في التطوير القائم على واجهات البرمجة أولاً فيُصمَّم العقد، وغالباً بصيغة OpenAPI، ويُعتمد قبل بناء التنفيذ أو واجهة المستخدم.
لماذا يرتبط النهج القائم على واجهات البرمجة أولاً بوكلاء الذكاء الاصطناعي؟ (AI)
تقول الحلقة "Computer-Using Agents: How CUA Could Transform SaaS" إن واجهات البرمجة المستقرة تشكل العمود الفقري للأنظمة الذكية، وتتيح ربط الوكلاء والأنظمة وسير العمل بوضوح وقابلية للتنبؤ. كما يمكن لواجهة برمجة واحدة خلف بوابة أن تخدم عملاء الوكلاء إلى جانب عملاء الويب والهاتف.
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Experts and companies for this topic
Nobody has listed this topic yet. Add it to your profile.
Maintained by Mirko Peters (Microsoft MVP) · Last updated: