Basic terminology

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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