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

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

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

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

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

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

الأداة	الوصف
Git	تتوفّر النماذج على GitHub. إذا لم يكن Git مثبّتًا، يُرجى الرجوع إلى تعليمات إعداد Git على GitHub. إذا كنت لا تريد تثبيت Git، يمكنك تصفُّح الملفات وتنزيل ملف ZIP من https://github.com/apigee/api-platform-samples.
Python	يجب توفّر Python لتشغيل أداة النشر في Apigee. يتوفّر Python في معظم بيئات Linux ، وعلى جهاز Mac مثبّت عليه XCode، وعلى جهاز Windows مثبّت عليه Cygwin، وفي العديد من الأماكن الأخرى. للحصول على Python، يُرجى الرجوع إلى صفحة تنزيل 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 دقائق.) اتّبِع التعليمات لنشر منتجات واجهة برمجة التطبيقات والمطوّرين والتطبيقات (المستخدَمة في 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

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