يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
المشكلة
حدث خطأ عند تقديم طلب مباشر من واجهة برمجة التطبيقات باستخدام Smart Docs من بوابة المطوّرين.
رسائل الخطأ
الخطأ الشائع الذي يظهر على "بوابة المطوِّر" هو "حدث خطأ داخلي. يُرجى إعادة محاولة تقديم طلبك".
الأسباب المحتملة
يمكن أن يحدث هذا الخطأ عندما تتعذر "بوابة مطوّر البرامج" في الحصول على استجابة من الخلفية (خادم وكيل Smartdocs أو نقطة النهاية الفعلية).
التشخيص
فعِّل "أدوات المطوّرين" في متصفحك وتحقَّق من علامة تبويب الشبكة لتحديد الخطأ الفعلي.
يتم عرض الأخطاء الشائعة وأسبابها النموذجية في الجدول التالي:
|
خطأ |
الأسباب النموذجية |
|
ERR_NAME_NOT_RESOLVED |
خادم وكيل Smart Docs الذي تم إعداده بشكلٍ خاطئ أو قيود جدار الحماية للشبكة |
|
محتوى مختلط |
تم إعداد البوابة عبر بروتوكول HTTPs، وطلب Smart Docs عبر HTTP |
|
500 - خطأ في الخادم الداخلي |
دعنا نتناول كلاً من هذه الأسباب واحدًا تلو الآخر وخطوات حل المشكلة.
ضبط الخادم الوكيل لمستندات Google الذكية بشكل غير صحيح أو قيود جدار الحماية للشبكة
تشير رسالة "ERR_NAME_NOT_RESOLVED" إلى أنه قد تم إعداد عنوان URL لخادم وكيل smartdocs بشكل خاطئ أو أنه يتعذر على الشبكة التي يتم الوصول من خلالها إلى البوابة الاتصال بعنوان URL لخادم وكيل smartdocs بسبب قيود جدار الحماية. يجب أن يكون الوصول إلى خادم smartdocs الوكيل متاحًا من الإنترنت أو من الشبكة الداخلية (لواجهات برمجة التطبيقات الداخلية).
درجة الدقّة
تأكد من إمكانية الوصول إلى خادم وكيل Smartdocs من جميع الشبكات المطلوبة من خلال نشر خادم وكيل smartdocs على مضيف افتراضي على Edge باستخدام اسم مضيف يمكن الوصول إليه من خلال الإنترنت.
تم إعداد البوابة عبر HTTPS، وطلب Smart Docs عبر HTTP
يشير خطأ "المحتوى المختلَط" إلى أنّه يتم استدعاء وكيل smartdocs عبر HTTP من صفحة تم تحميلها عبر HTTPS.
درجة الدقّة
اعرض وكيل Smartdocs عبر https لحل المشكلة. يمكنك إجراء ذلك من خلال نشر خادم وكيل smartdocs لتضمين مضيف افتراضي تم إعداده لاستخدام بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (عادةً ما يكون المضيف الافتراضي "الآمن").
خادم وكيل Smart Docs يعرض استثناءً
قد تظهر الرسالة 500 - خطأ في الخادم الداخلي بسبب مشكلة في الخادم الوكيل "smartdocs". في هذه الحالة، تلاحظ أن الخادم الوكيل smartdocs يعرض هذا الخطأ.
التشخيص
استخدِم أداة التتبُّع لتشخيص الأخطاء باستخدام الخادم الوكيل " Smartdocs"، كما هو موضّح أدناه. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام أداة التتبُّع.
- يمكنك تفعيل تتبُّع الخادم الوكيل "smartdocs" في مؤسسة "VALIDATE" لتحديد السياسة المحدّدة التي تعرض الخطأ 500 في الخادم الداخلي.
- اختَر السياسة المحدّدة في سجلّ التتبُّع لتحديد سبب الخطأ.
درجة الدقّة
أصلِح الخطأ الذي تم تحديده. إذا كنت بحاجة إلى المساعدة، يُرجى التواصل مع فريق دعم Apigee Edge.
يتعذّر على معالجات الرسائل على الحافة من طلب نقطة نهاية واجهة برمجة التطبيقات المنشورة
500: يمكن أن يحدث خطأ في الخادم الداخلي أيضًا عندما يتعذّر على معالِجات الرسائل التابعة للمؤسسة التي تستضيف الخادم الوكيل Smartdocs الاتصال بنقطة نهاية واجهة برمجة التطبيقات.
التشخيص
استخدِم أداة التتبُّع لتشخيص الأخطاء باستخدام الخادم الوكيل " Smartdocs"، كما هو موضّح أدناه. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام أداة التتبُّع.
- يمكنك تفعيل ميزة trace للخادم الوكيل "trace" في مؤسسة "trace" لتحديد موقع السياسة المحدّدة التي تعرض الخطأ 500 في الخادم الداخلي.
- في نموذج تتبُّع واجهة المستخدم الظاهر أعلاه، تبيّن أنّ سياسة JavaScript "BuildTargetAPIRequest" تفشل في تنفيذ عنوان URL المستهدف.
- احصل على عنوان URL المستهدف من سياسة JavaScript "BuildTargetAPIRequest".
- إجراء اتصال مباشر إلى عنوان URL من عُقد "معالج الرسائل" المرتبطة بمؤسسة "VALIDATE" كما هو موضّح أدناه:
curl -v <target URL>
- صحِّح أي خطأ تم ملاحظته.
درجة الدقّة
- يُرجى التأكّد من إمكانية استدعاء واجهات برمجة التطبيقات المنشورة على "بوابة المطوّرين" من معالِجات الرسائل المرتبطة بمؤسسة "VALIDATE" وتصحيح أي أخطاء قد تحدث.
- إذا كان بإمكانك تنفيذ طلب البيانات من واجهة برمجة التطبيقات مباشرةً من "معالج الرسائل"، من المرجّح جدًا أن تتمكّن من تنفيذ واجهة برمجة التطبيقات من خلال ميزة "مستندات Google الذكية" أيضًا.
- نفِّذ طلب بيانات من واجهة برمجة التطبيقات من خلال Smart Docs وتحقَّق مما إذا كان قد تم حل المشكلة.