فهم واجهات برمجة التطبيقات والخوادم الوكيلة لواجهة برمجة التطبيقات

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

تتيح لك Apigee Edge إنشاء واجهات برمجة تطبيقات RESTful بسهولة وسرعة يمكن لمطوّري التطبيقات استخدامها. يمكنك عرض واجهات برمجة التطبيقات على Edge من خلال إنشاء أدوات وكيل لواجهات برمجة التطبيقات تعمل بمثابة "واجهات" مُدارة لخدمات الخلفية. يتناول هذا الموضوع العلاقة بين واجهات برمجة التطبيقات ووكلاء واجهات برمجة التطبيقات على Apigee Edge.

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

ما هي واجهة برمجة التطبيقات؟

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

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

تتيح لك Apigee Edge إنشاء واجهات برمجة التطبيقات، وإذا كانت لديك واجهات برمجة تطبيقات، يمكنك عرضها مباشرةً، مع إضافة طبقة إدارة وإمكانية الوصول. إذا كانت لديك خدمات مفعَّلة باستخدام بروتوكول HTTP، مثل خدمات الويب المستندة إلى هندسة الخدمات المتكاملة (SOA)، يمكن أيضًا عرضها كواجهات برمجة تطبيقات من خلال Apigee Edge.

يتيح لك Edge أيضًا إنشاء واجهات برمجة التطبيقات من خلال تنفيذ تطبيقات مستضافة على منصة "خدمات واجهة برمجة التطبيقات"، بدون استخدام أي خدمة خلفية. يمكنك إنشاء هذه التطبيقات باستخدام JavaScript وJava وNode.js.

ما هو مُشفِّر واجهة برمجة التطبيقات؟

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

في إعدادات خادم وكيل واجهة برمجة التطبيقات، هناك نوعان من نقاط النهاية:

  • ‫ProxyEndpoint: تحدِّد هذه السمة طريقة استخدام تطبيقات العملاء لواجهات برمجة التطبيقات. عليك ضبط ProxyEndpoint لتحديد عنوان URL لخادم وكيل واجهة برمجة التطبيقات. وتحدِّد نقطة نهاية الخادم الوكيل أيضًا ما إذا كانت التطبيقات تصل إلى خادم وكيل واجهة برمجة التطبيقات عبر HTTP أو HTTPS. يتم عادةً إرفاق policies بـ ProxyEndpoint لفرض الأمان وعمليات التحقّق من الحصص والأنواع الأخرى من التحكّم في الوصول والحدّ من معدّل الإرسال.
  • ‫TargetEndpoint: يحدِّد طريقة تفاعل الخادم الوكيل لواجهة برمجة التطبيقات مع خدمات الخلفية. يمكنك ضبط TargetEndpoint لإعادة توجيه الطلبات إلى خدمة الخلفي المناسبة، بما في ذلك تحديد أي إعدادات أمان أو بروتوكول HTTP أو HTTPS ومعلومات اتصال أخرى. يمكنك إرفاق policies بـ TargetEndpoint لضمان تنسيق رسائل الرد بشكلٍ صحيح للتطبيق الذي قدّم الطلب الأوّلي.

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

تدخل طلبات HTTP من خلال نقطة نهاية طلب الخادم الوكيل، ويتم تمريرها إلى نقطة نهاية الطلب المستهدَف، ثم يتم إرسالها إلى خدمات الخلفية. تدخل استجابات HTTP من خلال نقطة نهاية الاستجابة المستهدَفة، ويتم تمريرها إلى نقطة نهاية الاستجابة للوكيل، ثم إلى العميل.

كيف يتم إنشاء خادم وكيل لواجهة برمجة التطبيقات؟

يتألّف الوكيل لواجهة برمجة التطبيقات من حِزمة من ملفات إعدادات XML والرموز البرمجية (مثل JavaScript و Java). يوفّر لك Apigee عدة طرق لإنشاء أدوات وكيل لواجهات برمجة التطبيقات، بما في ذلك:

  • استخدام واجهة مستخدِم إدارة Edge لتحديد وكيل واجهة برمجة التطبيقات في واجهة مستخدِم تصويرية (GUI) لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء وكيل واجهة برمجة تطبيقات بسيط.
  • إنشاء ملفات XML، بالإضافة إلى أي ملفات داعمة أخرى، لتحديد الوكيل لواجهة برمجة التطبيقات، ثمّ استيرادها إلى Edge
  • استخدام واجهة برمجة التطبيقات Edge management API لإنشاء أدوات إعادة التوجيه لواجهات برمجة التطبيقات من خلال إجراء سلسلة من طلبات REST إلى Edge
  • يمكنك نشر تطبيق Node.js كخادم وكيل. راجِع مقالة نشر تطبيق Node.js مستقل.

ما تعريف السياسة؟

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

إنشاء أول خادم وكيل لواجهة برمجة التطبيقات

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

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

مزيد من المعلومات