أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info
تتيح لك منصة Apigee Edge إنشاء واجهات برمجة تطبيقات RESTful بسهولة وسرعة، ويمكن لمطوّري التطبيقات استخدامها. يمكنك عرض واجهات برمجة التطبيقات على Edge من خلال إنشاء خوادم وكيلة لواجهة برمجة التطبيقات تعمل كـ "واجهات" مُدارة للخدمات الخلفية. يناقش هذا الموضوع العلاقة بين واجهات برمجة التطبيقات والخوادم الوكيلة لواجهة برمجة التطبيقات على Apigee Edge.
فيديو: يمكنك الاطّلاع على هذا الفيديو القصير للحصول على مقدّمة عن الخوادم الوكيلة لواجهة برمجة التطبيقات
ما هي واجهة برمجة التطبيقات؟
واجهة برمجة التطبيقات هي واجهة تسهّل على أحد التطبيقات "استخدام" الإمكانات أو البيانات من تطبيق آخر. من خلال تحديد نقاط دخول ثابتة ومبسّطة إلى منطق التطبيق وبياناته، تتيح واجهات برمجة التطبيقات للمطوّرين الوصول بسهولة إلى منطق التطبيق الذي أنشأه مطوّرون آخرون وإعادة استخدامه. في حالة "واجهات برمجة تطبيقات الويب"، يتم عرض هذا المنطق والبيانات عبر الشبكة.
بما أنّ التطبيقات التي تستخدم واجهات برمجة التطبيقات حساسة للتغييرات، فإنّ واجهات برمجة التطبيقات تتضمّن أيضًا "عقدًا". يوفّر العقد مستوى معيّنًا من الضمان بأنّ واجهة برمجة التطبيقات ستتغيّر بمرور الوقت بطريقة يمكن التنبؤ بها.
تتيح لك منصة Apigee Edge إنشاء واجهات برمجة التطبيقات، وإذا كانت لديك واجهات برمجة تطبيقات حالية، يمكنك عرضها مباشرةً، مع إضافة طبقة إدارة ورؤية. إذا كانت لديك خدمات مفعّلة لبروتوكول HTTP، مثل خدمات الويب المستندة إلى بنية الخدمات (SOA)، يمكن أيضًا عرضها كواجهات برمجة تطبيقات من خلال Apigee Edge.
تتيح لك منصة Edge أيضًا إنشاء واجهات برمجة التطبيقات من خلال تنفيذ التطبيقات المستضافة على منصة "خدمات واجهة برمجة التطبيقات" ، بدون أي خدمة خلفية. يمكنك إنشاء هذه التطبيقات بلغة JavaScript وJava، وعلى Node.js.
ما هو الخادم الوكيل لواجهة برمجة التطبيقات؟
يمكنك عرض واجهات برمجة التطبيقات على Apigee Edge من خلال تنفيذ خوادم وكيلة لواجهة برمجة التطبيقات. تفصل الخوادم الوكيلة لواجهة برمجة التطبيقات واجهة برمجة التطبيقات التي تظهر للتطبيق عن خدماتك الخلفية، ما يحمي هذه التطبيقات من تغييرات الرمز البرمجي الخلفي. عند إجراء تغييرات خلفية على خدماتك، ستواصل التطبيقات طلب واجهة برمجة التطبيقات نفسها بدون أي انقطاع.
في إعداد الخادم الوكيل لواجهة برمجة التطبيقات، هناك نوعان من نقاط النهاية:
- نقطة نهاية الخادم الوكيل: تحدّد الطريقة التي تستخدم بها تطبيقات العميل واجهات برمجة التطبيقات. يمكنك ضبط نقطة نهاية الخادم الوكيل لتحديد عنوان URL للخادم الوكيل لواجهة برمجة التطبيقات. تحدّد نقطة نهاية الخادم الوكيل أيضًا ما إذا كانت التطبيقات تصل إلى الخادم الوكيل لواجهة برمجة التطبيقات عبر HTTP أو HTTPS. عادةً ما يتم إرفاق السياسات بنقطة نهاية الخادم الوكيل لفرض الأمان وعمليات التحقّق من الحصص وأنواع أخرى من التحكّم في الوصول والحدّ من المعدّل.
- نقطة نهاية الهدف: تحدّد الطريقة التي يتفاعل بها الخادم الوكيل لواجهة برمجة التطبيقات مع خدماتك الخلفية. يمكنك ضبط نقطة نهاية الهدف لإعادة توجيه الطلبات إلى الخدمة الخلفية المناسبة، بما في ذلك تحديد أي إعدادات أمان وبروتوكول HTTP أو HTTPS ومعلومات الاتصال الأخرى. يمكنك إرفاق السياسات بنقطة نهاية الهدف لضمان تنسيق رسائل الرد بشكلٍ صحيح للتطبيق الذي قدّم الطلب الأولي.
يمكنك تصوُّر الخوادم الوكيلة لواجهة برمجة التطبيقات كما هو موضّح في الرسم البياني أدناه:
كيف يمكنك إنشاء خادم وكيل لواجهة برمجة التطبيقات؟
يتألف الخادم الوكيل لواجهة برمجة التطبيقات من حزمة من ملفات إعداد XML والرمز البرمجي (مثل JavaScript و Java). توفّر Apigee عدة طرق لإنشاء خوادم وكيلة لواجهة برمجة التطبيقات، بما في ذلك:
- استخدام واجهة إدارة Edge لتحديد خادم وكيل لواجهة برمجة التطبيقات في واجهة مستخدم تصويرية (GUI). لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إنشاء خادم وكيل بسيط لواجهة برمجة التطبيقات.
- إنشاء ملفات XML، بالإضافة إلى أي ملفات دعم أخرى، تحدّد الخادم الوكيل لواجهة برمجة التطبيقات و ثم استيرادها إلى Edge.
- استخدام واجهة برمجة تطبيقات إدارة Edge لإنشاء الخوادم الوكيلة لواجهة برمجة التطبيقات من خلال تقديم سلسلة من طلبات REST إلى Edge.
- نشر تطبيق Node.js كخادم وكيل. يمكنك الاطّلاع على مقالة نشر تطبيق Node.js مستقل.
ما تعريف السياسة؟
تتيح لك منصة Edge التحكّم في سلوك واجهة برمجة التطبيقات بدون كتابة أي رمز برمجي من خلال استخدام السياسات. السياسة تشبه وحدة نمطية تنفّذ وظيفة إدارة محدّدة ومحدودة كجزء من تدفق طلب/رد الخادم الوكيل. تم تصميم السياسات للسماح لك بإضافة أنواع شائعة من إمكانات الإدارة إلى واجهة برمجة التطبيقات بسهولة وموثوقية. توفّر السياسات ميزات مثل الأمان، الحدّ من المعدّل وإمكانات التحويل والوساطة، ما يوفّر عليك الحاجة إلى كتابة هذا المنطق والحفاظ عليه بنفسك.
إنشاء أول خادم وكيل لواجهة برمجة التطبيقات
توفّر Apigee مجموعة من البرامج التعليمية التي يمكنك استخدامها لإنشاء أول واجهة برمجة تطبيقات. ابدأ بمقالة إنشاء أول خادم وكيل لواجهة برمجة التطبيقات.
إحدى الطرق الرائعة للتعرّف على الخوادِم الوكيلة لواجهة برمجة التطبيقات هي استخدام النماذج كما هو موضّح في استخدام الخوادِم الوكيلة النموذجية لواجهة برمجة التطبيقات.