تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

المتطلبات الأساسية

ستحتاج إلى حساب على http://enterprise.apigee.com. يمكنك الاشتراك للحصول على حساب تجريبي على http://accounts.apigee.com/accounts/sign_up.

لاستخدام النماذج، يجب أن يتوفر لديك أيضًا ما يلي:

الأداة	الوصف
Git	العينات موجودة على جيت هب. إذا لم يكن Git مثبتًا لديك، يُرجى الرجوع إلى تعليمات إعداد git في GitHub إذا كنت لا تريد تثبيت Git، يمكنك تصفح الملفات وتنزيل ملف ZIP من https://github.com/apigee/api-platform-samples.
Python	يجب استخدام Python لتشغيل أداة النشر Apigee. تتوفّر لغة بايثون في معظم أنظمة Linux وعلى جهاز Mac تم تثبيت XCode عليه، وعلى جهاز Windows مُثبَّت عليه Cygwin، وفي العديد من الأماكن الأخرى. للحصول على لغة بايثون، يُرجى الرجوع إلى صفحة تنزيل Python.
`curl`	تستخدم نماذج النصوص البرمجية للإعداد أيضًا السمة `curl`. تأكَّد من تثبيت `curl` على مسارك (شغِّل الأمر `which curl` لمعرفة ما إذا كان متاحًا على نظامك).
`dos2unix`	إذا كنت تشغّل Cygwin على نظام التشغيل Windows، قد تحتاج أيضًا إلى `dos2unix` الأخرى. (يتيح لك مثبت Cygwin تثبيت الأداة.)

تنزيل النماذج

للحصول على نماذج الملفات، استخدِم git clone كما هو موضّح في المثال التالي:

git clone https://github.com/apigee/api-platform-samples.git

استيراد نموذج واجهة برمجة التطبيقات ونشره خوادم وكيلة

استيراد النماذج ونشرها من سطر الأوامر:

بعد تنزيل النماذج، انتقِل إلى الدليل /setup كما يبيِّن المثال التالي:
```
cd setup
```
في دليل /setup، حدِّد موقع الملف setenv.sh.
عدِّل هذا الملف لضبط إعدادات مؤسستك وعنوان البريد الإلكتروني المرتبط باسم المستخدم الخاص بك والبيئة (الإنتاج أو الاختبار) حيث تريد نشر الخوادم الوكيلة لواجهة برمجة التطبيقات.
بعد تعديل setenv.sh، يمكنك تنفيذ ما يلي:
```
sh deploy_all.sh
```
ينشر هذا النص البرمجي جميع نماذج الخادم الوكيل لواجهة برمجة التطبيقات إلى مؤسستك. (تستغرق العملية من 3 إلى 4 minutes.) اتّباع التعليمات لنشر منتجات واجهة برمجة التطبيقات ومطوّري البرامج والتطبيقات (التي تُستخدَم مع OAuth).
بعد اكتمال النشر النصي، انتقل إلى دليل sample-proxies. في جلسة المعمل، الدليل sample-proxies، ستجد دليلاً واحدًا لكل نموذج وكيل. في كل الدليل هو ملف README.md يحتوي على معلومات حول تشغيل العينة ونصين برمجيين عند إجراء تغييرات بسيطة على العينات، ونشرها، ثم استدعاؤها للاطّلاع على التأثير الذي أحدثته التغيير:
- invoke.sh: نفِّذ هذا النص البرمجي لاستدعاء الإصدار المنشور من واجهة برمجة التطبيقات الخادم الوكيل.
- deploy.sh: نفِّذ هذا النص البرمجي لنشر الخادم الوكيل لواجهة برمجة التطبيقات بعد إجراء أي التغييرات.

استدعاء نماذج الخوادم الوكيلة لواجهة برمجة التطبيقات

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

من الدليل /sample-proxies/proxy_name، نفِّذ عملية التالي:

sh invoke.sh

يؤدي ذلك إلى استدعاء الخادم الوكيل الذي يعمل في بيئة الاختبار في مؤسستك.

تحديد المشاكل وحلّها

للحصول على معلومات حول تحديد المشاكل وحلّها، يُرجى الاطّلاع على ما يلي:

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

الاستخدام المعتاد لنماذج الخوادم الوكيلة هو التعديل والنشر والاستدعاء. يمكّنك هذا من إجراء ثم معرفة تأثيرها على رسالة الرد.

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

/apiproxy/targets/target_name.xml

على سبيل المثال، لتوجيه نموذج مفتاح واجهة برمجة التطبيقات إلى خدمة الخلفية لديك، حدِّد موقع هذا الملف:

/apikey/apiproxy/targets/default.xml

إذا كانت الإعدادات التلقائية تشير إلى http://mocktarget.apigee.net، مثل:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

وتتوفر الخدمة الخلفية على http://api.myproject.com/، ثم تعديل الإعدادات لتبدو كما يلي:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://api.myproject.com/</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

بعد حفظ التغييرات، انشر الخادم الوكيل لواجهة برمجة التطبيقات كما هو موضّح في المثال التالي:

sh deploy.sh

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