Basic terminology

هي واجهة برمجة تطبيقات تسهّل على أحد التطبيقات استخدام الإمكانات أو البيانات من تطبيق آخر.

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

توفر Apigee ثروة من المعلومات حول واجهات برمجة التطبيقات وأفضل الممارسات لتطوير واستخدامها. للبدء، يمكنك الاطّلاع على ندوة API Design على الويب أو تنزيل الكتاب الإلكتروني المجاني Web API Design: The Missing Link Best Practices for Crafting Interfaces that Developers Love.

هو واجهة على Edge لواجهة برمجة تطبيقات واحدة أو أكثر أو لخدمات HTTP عامة أو تطبيقات (مثل Node.js).

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

تؤدي الواجهة التي يوفّرها خادم وكيل لواجهة برمجة التطبيقات إلى فصل واجهة برمجة التطبيقات التي يراها المطوّر عن الخادم الخلفي خدمات، ما يحمي المطوّرين من تغييرات الرموز البرمجية ويسمح بالابتكار على Edge بدون التأثير في فِرق التطوير الداخلية. أثناء إجراء فِرق التطوير تغييرات على الخادم الخلفي ، يواصل المطوّرون استدعاء الواجهة نفسها بدون انقطاع. تتيح لك Apigee عرض واجهات متعددة لواجهة برمجة التطبيقات نفسها، ما يتيح لك تخصيص توقيع واجهة برمجة التطبيقات لتلبية احتياجات فئات المطوّرين المختلفة في الوقت نفسه.

هي واجهات برمجة تطبيقات يتم تعريفها من خلال عناوين الشبكة ومعرّفات الموارد المنتظمة (URI). تتألف واجهة برمجة التطبيقات من مسار أساسي ومجموعة من موارد واجهة برمجة التطبيقات. يحدّد كل خادم وكيل لواجهة برمجة التطبيقات مسارًا أساسيًا، ويمكنه اختياريًا، مسارات متعددة لموارد واجهة برمجة التطبيقات. يمكنك اعتبار واجهة برمجة التطبيقات ببساطة مجموعة من معرّفات الموارد المنتظمة (URI)، تشترك جميعها في مسار أساسي مشترك.

لتسهيل إدارة واجهات برمجة التطبيقات، تعزّز Apigee معرّفات الموارد المنتظمة (URI) الأولية هذه بأسماء عرض وأوصاف. يتيح لك Edge إرفاق السياسات والرموز البرمجية بمعرّفات الموارد المنتظمة (URI)، ما يتيح التحكّم الدقيق في سلوك واجهات برمجة التطبيقات وإدارته.

هو مجموعة من موارد واجهة برمجة التطبيقات (معرّفات الموارد المنتظمة (URI)) بالإضافة إلى حصة، أو خطة خدمة، والتي يتم نشرها لمطوّري التطبيقات في وقت التصميم. يمكن بعد ذلك تجميع منتجات واجهة برمجة التطبيقات في حِزم واجهة برمجة التطبيقات لتحقيق الربح منها.

يرتبط مفتاح واجهة برمجة التطبيقات بمنتج واحد أو أكثر من منتجات واجهة برمجة التطبيقات، ما يفرض ربطًا بين تطبيق وحزمة معرّفات الموارد المنتظمة (URI) التي يُسمح للتطبيق باستخدامها.

هو اختصار لكلمة تطبيق. أصبح مصطلح تطبيق يشير إلى تطبيقات الأجهزة الجوّالة التي تستخدم واجهات برمجة التطبيقات. ينفّذ المطوّرون التطبيقات بلغات برمجة متنوعة وباستخدام تقنيات ومنصات مختلفة. على المطوّرين الذين يريدون استخدام واجهات برمجة التطبيقات تسجيل التطبيقات في مؤسسة أحد مزوّدي واجهات برمجة التطبيقات على Apigee Edge.

عند تسجيل التطبيق، تنشئ Apigee مفتاح واجهة برمجة تطبيقات ورمزًا سريًا يحدّدان الـ تطبيق. يضمّن المطوّر مفتاح واجهة برمجة التطبيقات في التطبيق، الذي يعرض المفتاح عند إرسال الـ طلبات. تفرض "خدمات واجهة برمجة التطبيقات" إجراءات أمان حول مفتاح واجهة برمجة التطبيقات من خلال التحقق المباشر من مفتاح واجهة برمجة التطبيقات أو من خلال بروتوكول OAuth.

هي سياق تنفيذ وقت التشغيل للخوادم الوكيلة لواجهة برمجة التطبيقات. يجب نشر خادم وكيل لواجهة برمجة التطبيقات في بيئة قبل أن يصبح من الممكن الوصول إلى واجهة برمجة التطبيقات التي يعرضها عبر الشبكة. يتم تلقائيًا توفير بيئتين للمؤسسات: test و prod.

• تُستخدم بيئة test عادةً لنشر الخوادم الوكيلة لواجهة برمجة التطبيقات أثناء التطوير.
• تُستخدم بيئة prod عادةً لترقية الخوادم الوكيلة لواجهة برمجة التطبيقات من بيئة الاختبار بعد تطويرها واختبارها بالكامل.

هي حاوية لجميع العناصر في حساب Apigee Edge، بما في ذلك الخوادم الوكيلة لواجهة برمجة التطبيقات ومنتجات واجهة برمجة التطبيقات وحِزم واجهة برمجة التطبيقات والتطبيقات والمطوّرين.

يجب أن يكون لديك حساب مستخدم لكل مؤسسة أنت عضو فيها. (سيكون لدى معظم المستخدمين حساب في مؤسسة واحدة فقط).

هي خطوة معالجة يتم تنفيذها كوحدة منطقية ذرية وقابلة لإعادة الاستخدام ضمن مسار معالجة خادم وكيل لواجهة برمجة التطبيقات.

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

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

هو إصدار واجهة برمجة التطبيقات التي يراها المطوّر.

على سبيل المثال، pivotaltracker.com/services/v3 أو api.enterprise.apigee.com/v1.

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