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

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

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

بالإضافة إلى الإرشادات الواردة هنا، قد تكون مشاركة المنتدى Apigee Edge Antipatterns مفيدة لك.

معايير التطوير

التعليقات والوثائق

  • أدخِل تعليقات مضمّنة في ضبطي ProxyEndpoint وTargetEndpoint. تعزّز التعليقات سهولة قراءة التدفق، خصوصًا عندما لا تكون أسماء ملفات السياسات وصفية بشكل كافٍ للتعبير عن الوظائف الأساسية للمسار.
  • تقديم تعليقات مفيدة تجنَّب نشر التعليقات الواضحة.
  • استخدام مسافة بادئة وتباعد ومحاذاة رأسية متسقة وما إلى ذلك

الترميز بنمط إطار العمل

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

  • لتفعيل إعداد DRY (أي "عدم تكرار العملية")، حيثما أمكن، يجب أن تنفِّذ إعدادات السياسات والنصوص البرمجية وظائف متخصصة وقابلة لإعادة الاستخدام. على سبيل المثال، يمكن تسمية السياسة المخصّصة لاستخراج معلَمات طلب البحث من رسائل الطلب بالاسم ExtractVariables.ExtractRequestParameters. ويمكن تسمية السياسة المخصّصة لإدخال عناوين CORS باسم AssignMessage.SetCORSHeaders. بعد ذلك، يمكن تخزين هذه السياسات في نظام التحكّم في المصدر وإضافتها إلى كل خادم وكيل لواجهة برمجة التطبيقات يحتاج إلى استخراج معلَمات أو ضبط عناوين CORS، بدون الحاجة إلى إنشاء إعدادات متكررة (وبالتالي أقلّ قابلية للإدارة).
  • أزِل السياسات والموارد غير المستخدَمة (JavaScript وJava وTalkBack وغيرها) من الخوادم الوكيلة لواجهة برمجة التطبيقات، لا سيّما الموارد الكبيرة التي قد تؤدي إلى إبطاء إجراءات الاستيراد والنشر.

اصطلاحات التسمية

  • يجب أن يكون اسم ملف السياسة name متطابقًا مع اسم ملف سياسة XML.
  • يجب أن تتطابق سمة name لسياسة النص البرمجي وسياسة ServiceCallout مع اسم ملف المورد.
  • على DisplayName وصف وظيفة السياسة بدقة لمستخدم لم يستخدم الخادم الوكيل لواجهة برمجة التطبيقات هذا من قبل.
  • قم بتسمية السياسات وفقًا لوظيفتها. تنصح Apigee بإنشاء اصطلاح تسمية متسق لسياساتك. على سبيل المثال، استخدِم بادئات قصيرة متبوعة بسلسلة من الكلمات الوصفية مفصولة بشرطة. على سبيل المثال، AM-xxx لسياسات AssignMessage. راجِع أيضًا أداة API.
  • استخدام الامتدادات المناسبة لملفات الموارد و.js لملفات JavaScript و.py للغة python و.jar لملفات Java JAR
  • يجب أن تكون أسماء المتغيرات متسقة. إذا اخترت نمطًا، مثل CamlCase أو Under_score، في حال أردت استخدامه في الخادم الوكيل لواجهة برمجة التطبيقات.
  • استخدِم بادئات المتغيّرات متى أمكن لتنظيم المتغيّرات استنادًا إلى الغرض منها، على سبيل المثال، Consumer.username وConsumer.password.

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

اعتبارات التصميم الأولية

  • للحصول على إرشادات حول تصميم واجهة برمجة تطبيقات RESTful، يمكنك تنزيل الكتاب الإلكتروني تصميم واجهة برمجة تطبيقات الويب: الرابط المفقود.
  • يمكن الاستفادة من سياسات Apigee Edge ووظائفه كلما أمكن ذلك لإنشاء خوادم وكيلة لواجهة برمجة التطبيقات. تجنَّب ترميز جميع منطق الخادم الوكيل في موارد JavaScript أو Java أو Python.
  • أنشِئ التدفقات بطريقة منظمة. يُفضل استخدام المسارات المتعددة، التي يكون لكل منها شرط واحد، على المرفقات الشرطية المتعددة في الملف المرجعي والمسار التالي نفسهما.
  • في حال عدم تنفيذ هذا الإجراء، أنشئ خادمًا وكيلاً تلقائيًا لواجهة برمجة التطبيقات باستخدام ProxyEndpoint BasePath في /. ويمكن استخدامها لإعادة توجيه الطلبات الأساسية من واجهة برمجة التطبيقات إلى موقع إلكتروني للمطوّرين أو لعرض استجابة مخصّصة أو تنفيذ إجراء آخر أكثر فائدة من عرض رمز messaging.adaptors.http.flow.ApplicationNotFound التلقائي.
  • يمكنك استخدام موارد TargetServer لفصل إعدادات TargetEndpoint عن عناوين URL المحدّدة، مع السماح بالترويج في مختلف البيئات.
    راجِع موازنة التحميل على مستوى الخوادم الخلفية.
  • إذا كانت لديك العديد من قواعد التوجيه، يمكنك إنشاء واحدة باعتبارها "تلقائية"، أي كقاعدة مسار بدون شرط. تأكَّد من تحديد قاعدة Routeرو التلقائية في النهاية في قائمة المسارات المشروطة. يتم تقييم Routeالقواعد من أعلى إلى أسفل في ProxyEndpoint.
    يُرجى الاطّلاع على مرجع ضبط الخادم الوكيل لواجهة برمجة التطبيقات.
  • حجم حزمة الخادم الوكيل لواجهة برمجة التطبيقات: لا يمكن أن يزيد حجم حِزم الخادم الوكيل لواجهة برمجة التطبيقات عن 15 ميغابايت. في Apigee Edge لخدمات Private Cloud، يمكنك تغيير الحدّ الأقصى المسموح به للحجم من خلال تعديل السمة thrift_framed_transport_size_in_mb في المواقع الجغرافية التالية: cassandra.yaml (في Cassandra) وconf/apigee/management-server/repository.properties.
  • تحديد إصدارات واجهة برمجة التطبيقات: للتعرّف على أفكار Apigee واقتراحاتها بشأن إصدارات واجهة برمجة التطبيقات، يمكنك الاطّلاع على عملية تحديد الإصدارات في الكتاب الإلكتروني Web API Design: The Missing Link.

تفعيل سياسة مشاركة الموارد المتعدّدة المصادر (CORS)

قبل نشر واجهات برمجة التطبيقات الخاصة بك، عليك تفعيل سياسة مشاركة الموارد المتعددة المصادر (CORS) على الخوادم الوكيلة لواجهة برمجة التطبيقات لإتاحة الطلبات من مصادر متعددة من جهة العميل.

إنّ CORS (مشاركة الموارد المتعدّدة المصادر) هي آلية عادية تسمح لاستدعاءات XMLHttpRequest (XHR) بلغة JavaScript التي يتم تنفيذها في صفحة الويب بالتفاعل مع الموارد من نطاقات غير المصدر. تُعدّ سياسة مشاركة الموارد المتعددة المصادر (CORS) حلاً شائعًا يتم تنفيذه على سياسة المصدر نفسه التي يتم فرضها من خلال جميع المتصفحات. على سبيل المثال، إذا أجريت طلب XHR لواجهة برمجة تطبيقات Twitter من خلال رمز JavaScript يتم تنفيذه في المتصفّح، لن ينجح الطلب. ويعود السبب في ذلك إلى أنّ النطاق الذي يعرض الصفحة على متصفّحك يختلف عن النطاق الذي يعرض واجهة برمجة تطبيقات Twitter. توفّر سياسة مشاركة الموارد المتعدّدة المصادر (CORS) حلاً لهذه المشكلة من خلال السماح للخوادم "بتفعيل" إذا كانت تريد إتاحة مشاركة الموارد من مصادر متعددة.

للحصول على معلومات حول تفعيل CORS على الخوادم الوكيلة لواجهة برمجة التطبيقات قبل نشر واجهات برمجة التطبيقات، راجِع إضافة دعم CORS إلى الخادم الوكيل لواجهة برمجة التطبيقات.

حجم حمولة الرسائل

لمنع حدوث مشاكل في الذاكرة في Edge، يتم تقييد حجم حمولة الرسالة إلى 10 ميغابايت. ويؤدي تجاوز هذه الأحجام إلى خطأ protocol.http.TooBigBody.

تمت مناقشة هذه المشكلة أيضًا في مشاركة منتدى Apigee هذه.

وفي ما يلي الاستراتيجيات الموصى بها للتعامل مع أحجام الرسائل الكبيرة في Edge:

  • بث الطلبات والردود يُرجى العِلم أنّه عند البث، لن تتمكّن السياسات من الوصول إلى محتوى الرسائل بعد ذلك. يُرجى الاطّلاع على طلبات البث والردود.
  • في الإصدار 4.15.07 من Edge الخاص بخدمة Private Cloud والإصدارات الأقدم، يمكنك تعديل ملف http.properties الخاص بمعالج الرسائل لزيادة الحدّ المسموح به في معلَمة HTTPResponse.body.buffer.limit. واحرص على اختبار الميزة قبل تفعيل التغيير في مرحلة الإنتاج.
  • في الإصدار 4.16.01 من Edge الخاص بخدمة Private Cloud والإصدارات الأحدث، يجب أن تتضمّن الطلبات ذات حمولة البيانات عنوان طول المحتوى، أو في حال بث العنوان "Transfer-Encoding: trunked". بالنسبة إلى طلب POST إلى خادم وكيل لواجهة برمجة التطبيقات مع حمولة فارغة، يجب أن يكون طول المحتوى 0.
  • في Edge الخاص بالإصدار 4.16.01 والإصدارات الأحدث من Edge، يمكنك ضبط السمات التالية في /opt/apigee/router.properties أو message-processor.properties لتغيير الحدود. راجِع ضبط الحدّ الأقصى لحجم الرسالة على جهاز التوجيه أو معالج الرسائل لمزيد من المعلومات.

    لكل من الموقعَين قيمة تلقائية "10m" مقابل 10 ميغابايت:
    • conf_http_HTTPRequest.body.buffer.limit
    • conf_http_HTTPResponse.body.buffer.limit

التعامل مع الأخطاء

  • استفِد من FaultRules لمعالجة جميع الأخطاء. (يتم استخدام سياسات PrepareFault لإيقاف تدفق الرسائل وإرسال المعالجة إلى مسار Faultالقواعد).
  • ضمن مسار Faultالقواعد، استخدِم سياسات AssignMessage لإنشاء الاستجابة للخطأ، وليس سياسات PromptFault. تنفيذ سياسات assignMessage بشكل مشروط استنادًا إلى نوع الخطأ الذي يحدث.
  • يتضمّن دائمًا معالِج تلقائي للأخطاء "استقبال الرسائل الخاطئة" بحيث يمكن ربط الأخطاء التي ينشئها النظام بتنسيقات الاستجابة للأخطاء التي يحدّدها العميل.
  • احرص دائمًا على أن تكون الردود على الأخطاء تتطابق مع أي تنسيقات عادية متوفّرة في شركتك أو مشروعك، إذا كان ذلك ممكنًا.
  • استخدِم رسائل خطأ مفيدة يمكن للإنسان فهمها تقترح حلاً لحالة الخطأ.

يُرجى الاطّلاع على أخطاء المناولة.

لمعرفة أفضل الممارسات في المجال، يمكنك الاطّلاع على تصميم الاستجابة للأخطاء في RSTful.

الاستمرارية

خرائط القيمة/المفتاح

  • استخدِم خرائط المفتاح/القيمة فقط لمجموعات البيانات المحدودة. وهي غير مصمَّمة لتخزين بيانات طويل المدى.
  • ننصحك بمراعاة الأداء عند استخدام خرائط المفتاح/القيم لأنّه يتم تخزين هذه المعلومات في قاعدة بيانات Cassandra.

يمكنك الاطّلاع على سياسة عمليات ربط القيم الأساسية.

التخزين المؤقت للردود

  • لا تملأ ذاكرة التخزين المؤقت للاستجابة إذا لم تكن الاستجابة ناجحة أو إذا لم يكن الطلب GET. يجب عدم تخزين عمليات الإنشاء والتحديثات والحذف في ذاكرة التخزين المؤقت. <SkipCachePopulation>response.status.code != 200 or request.verb != "GET"</SkipCachePopulation>
  • تعبئة ذاكرة التخزين المؤقت بنوع محتوى واحد ثابت (مثل XML أو JSON) بعد استرداد إدخالResponseCache، يمكنك التحويل إلى نوع المحتوى المطلوب باستخدام JSONtoXML أو XMLToJSON. وسيمنع ذلك تخزين بيانات مزدوجة أو ثلاثية أو أكثر.
  • تأكَّد من أنّ مفتاح ذاكرة التخزين المؤقت كافٍ لمتطلّب التخزين المؤقت. وفي كثير من الحالات، يمكن استخدام request.querystring كمعرّف فريد.
  • لا تضمِّن مفتاح واجهة برمجة التطبيقات (client_id) في مفتاح ذاكرة التخزين المؤقت، ما لم يُطلب ذلك صراحةً. وفي أغلب الأحيان، ستعرض واجهات برمجة التطبيقات المؤمّنة باستخدام مفتاح فقط البيانات نفسها لجميع العملاء بخصوص طلب معيّن. من غير الفعّال تخزين القيمة نفسها لعدد من الإدخالات استنادًا إلى مفتاح واجهة برمجة التطبيقات.
  • حدِّد فواصل مناسبة لانتهاء صلاحية ذاكرة التخزين المؤقت لتجنّب القراءة غير النظيفة.
  • حاوِل قدر الإمكان تنفيذ سياسة ذاكرة التخزين المؤقت للاستجابة التي تملأ ذاكرة التخزين المؤقت في استجابة ProxyEndpoint PostFlow في أسرع وقت ممكن. بعبارة أخرى، يمكنك تنفيذ هذا الإجراء بعد خطوات الترجمة والتوسّط، بما في ذلك التوسّط والتحويل المستند إلى JavaScript، وذلك بين JSON وXML. من خلال التخزين المؤقت للبيانات المستندة إلى التوسّط، يمكنك تجنُّب تكلّف أداء تنفيذ خطوة التوسّط في كل مرة تستردّ فيها بيانات مخزَّنة مؤقتًا.

    يُرجى العلم أنّه قد تحتاج بدلاً من ذلك إلى تخزين البيانات التي لا تعتمد على التوسّط في ذاكرة التخزين المؤقت إذا أدى التوسّط إلى استجابة مختلفة عن الطلب إلى الطلب.

  • من المفترض أن تحدث سياسة ذاكرة التخزين المؤقت للاستجابة للبحث عن إدخال ذاكرة التخزين المؤقت في PreFlow لطلب ProxyEndpoint. تجنَّب تنفيذ الكثير من المنطق، بخلاف إنشاء مفتاح ذاكرة التخزين المؤقت، قبل عرض إدخال ذاكرة تخزين مؤقت. وإلا، سيتم تقليل مزايا التخزين المؤقت.
  • بشكل عام، يجب دائمًا إبقاء عملية بحث ذاكرة التخزين المؤقت الخاصة بالاستجابة قريبة قدر الإمكان من طلب العميل. وفي المقابل، عليك إبقاء بيانات ذاكرة التخزين المؤقت للاستجابة قريبة قدر الإمكان من استجابة العميل.
  • عند استخدام عدة سياسات مختلفة ومختلفة لذاكرة التخزين المؤقت للاستجابة في خادم وكيل، يُرجى اتّباع هذه الإرشادات لضمان تنفيذ سلوك منفصل لكل منها:
    • تنفيذ كل سياسة استنادًا إلى شروط حصرية تبادلية. سيساعد ذلك في ضمان تنفيذ سياسة واحدة فقط من سياسات ذاكرة التخزين المؤقت للاستجابة المتعددة.
    • يمكنك تحديد موارد ذاكرة تخزين مؤقت مختلفة لكل سياسة ذاكرة تخزين مؤقت للاستجابة. وتحدد مورد ذاكرة التخزين المؤقت في عنصر <CacheResource> الخاص بالسياسة.

يُرجى الاطّلاع على سياسة ذاكرة التخزين المؤقت للاستجابة.

السياسة والرمز المخصّص

رمز سياسة أم مخصص؟

  • استخدِم السياسات المضمَّنة أولاً وقبل كل شيء (إن أمكن ذلك). يتم تقوية سياسات Apigee وتحسينها وإتاحتها. على سبيل المثال، يمكنك استخدام السياستَين العاديتَين AssignMessage واستخراجVariables بدلاً من JavaScript (إن أمكن) لإنشاء حمولات واستخراج المعلومات من الحمولات (XPath وJSONPath) وما إلى ذلك.
  • يُفضل استخدام JavaScript على Python وJava. ومع ذلك، إذا كان الأداء هو المطلب الأساسي، يجب استخدام لغة Java على JavaScript.

JavaScript

  • استخدِم JavaScript إذا كانت أكثر سهولة من سياسات Apigee (على سبيل المثال، عند ضبط target.url للعديد من تركيبات معرّف الموارد المنتظم (URI) المختلفة).
  • تحليل معقد الحمولات، مثل التكرار من خلال كائن JSON وترميز/فك ترميز Base64
  • سياسة JavaScript لها حد زمني، وبالتالي يتم حظر التكرارات اللانهائية.
  • يجب دائمًا استخدام خطوات JavaScript ووضع الملفات في مجلد موارد jsc. يعمل نوع سياسة JavaScript على تجميع الرمز مسبقًا في وقت النشر.

راجِع برمجة الخوادم الوكيلة لواجهة برمجة التطبيقات باستخدام JavaScript.

Java

  • استخدِم لغة Java إذا كان الأداء هو الأولوية القصوى أو إذا تعذّر تنفيذ المنطق في JavaScript.
  • تضمين ملفات مصدر Java في تتبع رمز المصدر.

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

Python

  • لا تستخدم Python إلا في حالة الضرورة القصوى. يمكن أن تؤدي نصوص لغة بايثون إلى التأثير سلبًا في الأداء في عمليات التنفيذ البسيطة، إذ يتم تفسيرها في وقت التشغيل.

وسائل شرح النصوص البرمجية (Java وJavaScript وPython)

  • استخدِم تجربة عالمية أو ما يعادلها.
  • ويمكنك طرح استثناءات ذات معنى وتحديدها بشكل صحيح لاستخدامها في الردود على الأخطاء.
  • ننصحك بطرح الاستثناءات والحصول على الاستثناءات مبكرًا. ولا تستخدم المحاولة/الالتقاط العالمي لمعالجة جميع الاستثناءات.
  • إجراء عمليات تحقّق فارغة وغير محدّدة عند الضرورة ومن الأمثلة على حالات تنفيذ ذلك عند استرداد متغيّرات التدفق الاختيارية.
  • تجنَّب إنشاء طلبات HTTP/S داخل وسيلة شرح النص البرمجي. بدلاً من ذلك، يمكنك استخدام سياسة Apigee ServiceCallout حيث إنّ السياسة تتعامل مع الاتصالات بشكل آمن.

JavaScript

  • إنّ JavaScript على النظام الأساسي لواجهة برمجة التطبيقات يتوافق مع تنسيق XML عبر E4X.

يمكنك الاطّلاع على نموذج عنصر JavaScript.

Java

  • عند الوصول إلى حمولات الرسائل، جرِّب استخدام context.getMessage() بدلاً من context.getResponseMessage أو context.getRequestMessage. ويضمن ذلك أن الرمز البرمجي يمكنه استرداد الحمولة في كلٍ من مسارَي الطلب والاستجابة.
  • استورِد المكتبات إلى مؤسسة أو بيئة Apigee Edge ولا تضمِّنها في ملف JAR. يقل حجم الحزمة وسيسمح لملفات JAR الأخرى بالوصول إلى مستودع المكتبة نفسه.
  • يمكنك استيراد ملفات JAR باستخدام واجهة برمجة تطبيقات موارد Apigee بدلاً من تضمينها في مجلد موارد الخادم الوكيل لواجهة برمجة التطبيقات. سيؤدي ذلك إلى تقليل أوقات النشر والسماح بالإحالة إلى ملفات JAR نفسها من خلال عدّة خوادم وكيل لواجهة برمجة التطبيقات. هناك فائدة أخرى تتمثل في عزل برنامج تحميل الفئة.
  • لا تستخدم Java لمعالجة الموارد (على سبيل المثال، إنشاء مجموعات سلاسل التعليمات وإدارتها).

راجِع تحويل الردّ إلى أحرف كبيرة باستخدام وسيلة شرح بلغة Java.

Python

  • طرح استثناءات ذات معنى وتحديدها بشكل صحيح لاستخدامها في الردود على أخطاء Apigee

يمكنك الاطّلاع على سياسة النص البرمجي في Python.

ServiceCallouts

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

    في حال إجراء اتصال بين الخوادم الوكيلة التي تعمل في المؤسسة والبيئة نفسها، احرص على الاطّلاع على الخوادم الوكيلة لواجهة برمجة التطبيقات المتسلسلة معًا لمزيد من المعلومات حول تنفيذ اتصال محلي يتجنّب الحِمل غير الضروري على الشبكة.

  • أنشئ رسالة طلب ServiceCallout باستخدام سياسة AssignMessage، واملأ كائن الطلب في متغيّر رسالة. (يشمل ذلك ضبط حمولة الطلب والمسار والطريقة).
  • يتطلب عنوان URL الذي يتم ضبطه ضمن السياسة مواصفات البروتوكول، ما يعني أنّ جزء البروتوكول لعنوان URL، على سبيل المثال https://، لا يمكن تحديده بواسطة متغيّر. يجب أيضًا استخدام متغيّرات منفصلة لجزء النطاق من عنوان URL وباقي عنوان URL. مثال: https://{domain}/{path}
  • تخزين كائن الاستجابة لـ ServiceCallout في متغير رسالة منفصل. يمكنك بعد ذلك تحليل متغيّر الرسالة والحفاظ على حمولة الرسالة الأصلية بدون تغيير لتستخدمها سياسات أخرى.

يُرجى الاطّلاع على سياسة وسائل شرح الخدمة.

الوصول إلى العناصر

سياسة AccessEntity

  • للحصول على أداء أفضل، ابحث عن تطبيقات حسب uuid بدلاً من اسم التطبيق.

يُرجى الاطّلاع على سياسة كيان الوصول.

التسجيل

  • استخدِم سياسة سجل نظام مشتركة عبر الحزم وداخل الحزمة نفسها. وسيؤدي ذلك إلى الحفاظ على تنسيق تسجيل متّسق.

اطِّلع على سياسة MessageLogging.

المراقبة

ولا يُطلب من عملاء السحابة الإلكترونية التحقّق من المكوّنات الفردية Apigee Edge (الموجهات، معالِجات الرسائل، وما إلى ذلك). يراقب فريق العمليات العالمية في Apigee جميع المكوّنات بدقة، بالإضافة إلى عمليات التحقق من سلامة واجهة برمجة التطبيقات، بناءً على طلبات العميل لعمليات التحقّق من الصحة.

إحصاءات Apigee

يمكن أن توفّر "إحصاءات Google" عمليات مراقبة غير أساسية لواجهة برمجة التطبيقات، حيث يتم قياس النسب المئوية للأخطاء.

اطّلع على لوحات بيانات "إحصاءات Google".

التتبّع

تُعدّ أداة التتبّع في واجهة مستخدم إدارة واجهة برمجة التطبيقات Edge مفيدة لتصحيح مشاكل واجهة برمجة التطبيقات في وقت التشغيل أثناء عملية تطوير واجهة برمجة تطبيقات أو إنتاجها.

راجِع استخدام أداة التتبُّع.

الأمان

  • يمكنك استخدام سياسات تقييد عنوان IP لتقييد إمكانية الوصول إلى بيئة الاختبار. السماح بالوصول إلى عناوين IP لأجهزة أو بيئات التطوير التي تستخدمها وعدم السماح بجميع العناصر الأخرى سياسة AccessControl.
  • طبِّق دائمًا سياسات حماية المحتوى (بتنسيق JSON أو XML) على الخوادم الوكيلة لواجهة برمجة التطبيقات التي تم نشرها في عملية الإنتاج. سياسة JSONThreatProtection:
  • يُرجى الاطِّلاع على المواضيع التالية للتعرّف على مزيد من أفضل ممارسات الأمان: