يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
تحتوي نماذج واجهة برمجة التطبيقات Apigee Edge API على نماذج من الخوادم الوكيلة لواجهة برمجة التطبيقات والسياسات والرموز والأدوات التي توضّح إمكانات خدمات واجهة برمجة التطبيقات Apigee Edge الموضحة أدناه.
للحصول على إرشادات حول استخدام النماذج، يُرجى الاطّلاع على استخدام نماذج الخوادم الوكيلة لواجهة برمجة التطبيقات.
التعلُّم بالممارسة
هل تريد تنظيف أيديك سريعًا والبدء في بناء قاعدة معرفية قوية حول Apigee Edge؟ لدينا مكتبة من نماذج "التعلُّم المتطورة" في GitHub التي تتيح لك نشر بعض نماذج الخوادم الوكيلة واستدعاءها وتتبعها بسرعة، بدءًا بأبسط الخادم الوكيل والانتقال إلى الخوادم الوكيلة التي توضح عملية التحقق من مفتاح واجهة برمجة التطبيقات، والحصة، والتخزين المؤقت للاستجابة، ومعالجة الأخطاء، والمزيد.
بعد استنساخ المخزن وإعداد بيئتك (يستغرق ذلك بضع دقائق فقط)، يمكنك تجربة كل عيّنة في أقل من دقيقة. وبما أنّ كل عيّنة تنشئ نسخة مراجعة جديدة من الخادم الوكيل نفسه، لن تزدحم بيئتك بالعديد من العيّنات. ويمكنك تبديل النُسخ السابقة وإعادة نشر نسخة سابقة في واجهة مستخدم الإدارة والاطّلاع على رمز الخادم الوكيل في أي وقت. يقدّم لك القسم التمهيدي لكل عيّنة ملخّصًا موجزًا عن نشاط العيّنة وطريقة إعدادها.
جرِّب هذه الميزة الآن. https://github.com/apigee/api-platform-samples/tree/master/learn-edge
عيّنات من كتب الطهي في مستند
يتم تقديم مجموعة من العيّنات لمواضيع كتاب الطبخ الوكيل لواجهة برمجة التطبيقات.
| الاسم | الوصف | أنواع السياسة | المراجِع |
|---|---|---|---|
| JavaScript-cookbook | يوضِّح مقتطف JavaScript بسيطًا يضيف عناوين HTTP من المتغيرات، ويحوِّل تقرير الطقس بتنسيق XML من JSON إلى XML، ويزيل المحتوى بالنسبة إلى برامج الأجهزة الجوّالة. | min.js setHeaders.js |
|
| JavaScript-mashup-cookbook | هو تطبيق JavaScript كامل يستدعي واجهات برمجة تطبيقات متاحة للجميع ويدمج النتائج وينشئ استجابة مفصّلة لتطبيق العميل. (ملاحظة: ينفّذ الخادم الوكيل لواجهة برمجة التطبيقات هذا الوظائف نفسها التي تنفّذها عملية دمج السياسات، ما يوضّح أنّه يمكن معالجة المشكلة نفسها باستخدام أساليب مختلفة). | JavaScript | MashItUp.js |
| JavaScript-hello | وسيلة شرح بسيطة عبر لغة Java حول العالم. | JavaCallout | JavaHello.java |
| java-cookbook | لتحويل محتوى الاستجابة والعناوين إلى أحرف كبيرة. | JavaCallout |
ResponseUppercase.java |
| java-properties | توضح كيفية استخدام الخصائص في وسيلة شرح Java. | JavaCallout | JavaProperties.java |
| JavaScript-error | يوضح أنماط التعامل مع الأخطاء التي يمكنك استخدامها في رمز وسيلة شرح Java. | JavaCallout | JavaError.java |
| دليل-مزج السياسات | هو تطبيق كامل يستخدم إعداد السياسة لاستدعاء واجهتَي برمجة تطبيقات متاحتَين للجميع مع دمج النتائج وإنشاء استجابة مفصّلة لتطبيق العميل. (ملاحظة: ينفِّذ الخادم الوكيل لواجهة برمجة التطبيقات هذا الوظائف نفسها التي تنفّذها عملية مزج JavaScript، ما يوضّح أنّه يمكن معالجة المشكلة نفسها باستخدام أساليب مختلفة). | AssignMessage ServiceCallout ExtractVariables JavaScript XMLToJSON |
GenerateResponse.js |
نماذج الخوادم الوكيلة لواجهة برمجة التطبيقات
يمكن العثور على الخوادم الوكيلة التالية لواجهة برمجة التطبيقات في GitHub، حيث توفر الصفحات التمهيدية أوصافًا مفصّلة للنماذج. إذا كنت مهتمًا بكيفية عمل سياسة معيّنة في أحد النماذج، يمكنك الاطّلاع على العمود "أنواع السياسات" أدناه لمعرفة السياسة التي تهمّك، ثم النقر على اسم النموذج في عمود "الاسم". (تتضمّن السياسات روابط إلى الصفحات المرجعية الخاصة بكل منها.)
المراجع والأدوات
بالإضافة إلى نماذج كتب طهي المستندات ونماذج الخوادم الوكيلة في الجداول أعلاه، تحتوي نماذج Edge GitHub أيضًا على الموارد التالية:
| الاسم | الوصف | أنواع السياسة | المراجِع |
|---|---|---|---|
| الحماية الافتراضية | يمكن لسياسة الحماية من تهديدات التعبير العادي حماية واجهات برمجة التطبيقات والخدمات الدقيقة في الخلفية من هجمات حقن SQL. | لا ينطبق | |
| oauth-validate-key-secret | يجري تنفيذ مسار نوع منح كلمة مرور OAuth. تحتاج إلى التحقق من كل من مفتاح العميل للتطبيق والمفتاح السري على Edge قبل الاتصال بموفِّر هوية خارجي للتحقق من صحة بيانات اعتماد المستخدم. | OAuthV2 وأنظمة أخرى | لا ينطبق |
| مطابقة أنماط الحالة | يتيح لك هذا الخادم الوكيل تجربة العبارات الشرطية بسهولة واختبارها في مسار الخادم الوكيل لواجهة برمجة التطبيقات. | AssignMessage | لا ينطبق |
| جهة الوصول | يعرض كيفية استرداد الملفات الشخصية للكيانات من مخزن بيانات Apigee Edge. | AssignMessage AccessEntity ExtractVariables |
لا ينطبق |
| apikey | تنفيذ عملية بسيطة للتحقّق من مفتاح واجهة برمجة التطبيقات | VerifyAPIKey AssignMessage الحصة |
لا ينطبق |
| وسيلة شرح غير متزامنة | يوضح وسيلة شرح بسيطة غير متزامنة باستخدام httpClient في JavaScript. | JavaScript | assemble_response.js وسيلة الشرح.js |
| base64encoder | يوضح كيفية استدعاء يتضمن محتوى JavaScript من موارد JavaScript في الخوادم الوكيلة لواجهة برمجة التطبيقات. | AssignMessage JavaScript |
Core-min.js enc-utf16-min.js enc-base64-min.js encodeAuthHeader.js |
| السياسة الشرطية | تنفيذ سياسة مشروطة بسيطة. عندما يحتوي طلب على عنوان الاستجابة HTTP:true، تنفِّذ السياسة نص برمجي بلغة Python تضيف مجموعة من مقاييس الأداء إلى رسالة الاستجابة، كعناوين HTTP | النص البرمجي (Python) | timer.py |
| نقطة نهاية ديناميكية | يتم تنفيذ توجيه مشروط بسيط في سيناريو أكثر تعقيدًا، ويحدد عنوانَي URL ومسارًا تلقائيًا واحدًا. | لا ينطبق | لا ينطبق |
| ملاحظات إصدار jira | هذا هو وكيل واجهة برمجة التطبيقات الذي يستخدمه فريق مستندات Apigee لإنشاء ملاحظات الإصدار من Jira. | JSONToXML XSL |
releasenotes_api.xsl |
| kerberos-credential- موسيقى | يعرض هذا النموذج كيفية إجراء توسّط Kerberos لبيانات الاعتماد على Apigee Edge. | JavaCallout | ملف Java JAR |
| oauth-advanced | مثال كامل وفعّال لمسار نوع منح رمز التفويض، مع جعل Apigee Edge خادم التفويض. |
GenerateAccessToken أشخاص آخرون... |
الاطّلاع على الرمز النموذجي |
| بيانات اعتماد oauth-client | يعرض نقطة نهاية لرمز OAuth 2.0 المميز بكامل وظائفه، وتم إعدادها لنوع منح بيانات اعتماد العميل. | GenerateAccessToken | لا ينطبق |
| oauth-login-app | تمّ الإيقاف. ننصحك بالاطّلاع على النموذج oauth-advanced بدلاً من ذلك. | ||
| oauth-validate-key-secret | توضيح أسلوب للتحقق من صحة مفتاح وسر العميل قبل الاتصال بموفِّر هوية لإثبات صحة بيانات اعتماد المستخدم في مسار نوع منح كلمة المرور. | OAuthV2 AssignMessage ExtractVariables ServiceCallout RaiseFault |
لا ينطبق |
| oauth-verify-accesstoken | يوضح الخادم الوكيل لواجهة برمجة التطبيقات الذي تم إعداده للتحقّق من صحة رموز الدخول عبر OAuth 2.0 والتحقّق من الحصة. | VerifyAccessToken الحصة |
لا ينطبق |
| oauth10a-3leg | يوضح تهيئة OAuth 1.0a الثلاثية. | GenerateAceessToken GenerateRequestToken ServiceCallout VerifyAccessToken |
لا ينطبق |
| outbound-oauth | تستخدم واجهة برمجة تطبيقات Microsoft Azure translator لترجمة التغريدات. لإجراء ذلك، تُجري الخدمة مكالمة خارجية للحصول على رمز دخول OAuth، ثم تخزّن الرمز المميّز مؤقتًا باستخدام سياسات التخزين المؤقت لخدمات واجهة برمجة التطبيقات، مع إعادة استخدام الرمز المميّز المُخزَّن مؤقتًا في كل مرة يتم فيها إجراء مكالمة صادرة. ويتضمّن أيضًا تطبيق متصفّح توضيحيًا يُستخدَم لاستدعاء الخادم الوكيل لواجهة برمجة التطبيقات. | AssignMessage LookupCache PopulateCache JavaScript |
api-config.js api-token-get.js translate-query.js translate-results.js |
| التقسيم على صفحات | يتم تقسيم رسالة الاستجابة XML على صفحات استنادًا إلى معلَمات الحدود والإزاحة التي يوفّرها البرنامج | AssignMessage ExtractVariables ResponseCache VerifyApiKey XSL |
paginate.xslt |
| Response-cache | توضح كيفية تخزين توقعات الطقس مؤقتًا على Edge لمدة 10 دقائق. | ResponseCache AssignMessage |
لا ينطبق |
| simple-python | يوضح هذا النموذج سيناريو بسيط لإرفاق نص برمجي بلغة python في الاستجابة يضيف إليه قيمة عنوان. |
النص البرمجي (Python) | setHeader.py |
| صابون | يوضّح تحويل XSL الذي يعيد كتابة ملف WSDL استجابةً لطلب يتضمّن مَعلمة طلب البحث ?wsdl. | AssignMessage ExtractVariables نص برمجي (Python) XSL |
accountaddress.py fixwsdl.xlsx |
| بث | يوضح إعداد بث HTTP. | لا ينطبق | لا ينطبق |
| إعادة توجيه الهدف | تُستخدَم لتوضيح استخدام JavaScript لاختيار عنوان URL مستهدف ديناميكيًا استنادًا إلى محتوى رسالة الطلب. | ExtractVariables JavaScript |
rewriteTargetUrl.js |
| المخطط الزمني لخدمة twitter-mobile-time | توضيح كيفية استخدام JavaScript لإزالة المعلَمات غير الضرورية من التغريدات، ما يؤدي إلى إنشاء مخطّط زمني مبسّط على Twitter ومتوافق مع الأجهزة الجوّالة محدودة الموارد | AssignMessage JavaScript |
MobileTimeline.js |
| twitter-oembed | تحوِّل هذه الدالة استجابات المخطط الزمني (على سبيل المثال من Status/user_timeline.json) إلى استجابة oembed التي تتضمّن بيانات المخطط الزمني على شكل محتوى HTML غني. | AssignMessage JavaScript |
search-oembed.js |
| المتغيّرات | يوضح كيفية استخراج المتغيّرات وضبطها بناءً على بيانات النقل ومحتوى رسالة JSON وXML. | AssignMessage ExtractVariables XMLToJSON |
minimize.js |
| xmltojson | تحوِّل بيانات الاستجابة من XML إلى JSON. | XMLToJSON JSONToXML |
لا ينطبق |
|
|
ملفات مخطّط XML التي يمكنك استخدامها كمرجع عند ضبط الخوادم الوكيلة لواجهة برمجة التطبيقات والسياسات ومنتجات واجهة برمجة التطبيقات والملفات الشخصية للمطوّرين والتطبيقات. |
||
|
|
يحتوي على أداة نشر، publish.py، تستورد خادم وكيل لواجهة برمجة التطبيقات إلى مؤسسة على Apigee Edge وتنشره على البيئة المحددة. |
||
|
|
تسترد أداة "نبذة عن المؤسسة" إعدادات المؤسسة، بما في ذلك المطوّرين ومنتجات واجهة برمجة التطبيقات والمضيفين الافتراضيين وخرائط المفتاح/القيمة وما إلى ذلك. ويمكن استخدامها للاحتفاظ بنسخة احتياطية من تفاصيل مؤسسة ما أو لاكتشاف الإعدادات في مؤسسة. |
Apigee-127
إذا كنت مبرمجًا، سيوفّر لك Apigee-127 إمكانية ترميز الخوادم الوكيلة لواجهة برمجة التطبيقات باستخدام Node.js وSwagger. يمكنك أيضًا العثور على نماذج a127 على GitHub: https://github.com/apigee-127/a127-samples.
مشاركة تجربتك
شارِك تجاربك على منتدى Apigee Developer.