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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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