Basic terminology

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

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

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

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

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

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

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

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

مجموعة من موارد واجهة برمجة التطبيقات (عناوين URL) مع حصة أو خطة خدمة يتم نشرها لمطوّري التطبيقات في وقت التصميم ويمكن تجميع منتجات واجهة برمجة التطبيقات بدورها في حِزم واجهة برمجة التطبيقات لتحقيق الربح.

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

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

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

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

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

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

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

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

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

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

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

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

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