أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
المشكلة
حدث خطأ عند إجراء طلب بيانات من واجهة برمجة التطبيقات مباشرةً باستخدام SmartDocs من بوابة المطوّرين.
رسائل الخطأ
الخطأ الشائع الذي يظهر في "بوابة المطوّرين" هو "حدث خطأ داخلي. يُرجى إعادة محاولة طلبك".
الأسباب المحتمَلة
يمكن أن يحدث هذا الخطأ عندما يتعذّر على "بوابة المطوّرين" الحصول على ردّ من النظام الخلفي (الخادم الوكيل smartdocs أو نقطة النهاية الفعلية).
التشخيص
فعِّل "أدوات المطوّرين" في متصفّحك واطّلِع على علامة التبويب "الشبكة" لـ تحديد الخطأ الفعلي.
يرد في الجدول التالي الأخطاء الشائعة وأسبابها النموذجية:
|
خطأ |
الأسباب النموذجية |
|
ERR_NAME_NOT_RESOLVED |
الخادم الوكيل SmartDocs الذي تم ضبطه بشكل غير صحيح أو القيود التي يفرضها جدار حماية الشبكة |
|
محتوى مختلط |
تم ضبط البوابة على بروتوكول HTTPS، وطلب SmartDocs على بروتوكول HTTP |
|
500 - خطأ في الخادم الداخلي |
لننتقل إلى كل سبب من هذه الأسباب على حدة والخطوات اللازمة لحلّ المشكلة.
الخادم الوكيل SmartDocs الذي تم ضبطه بشكل غير صحيح أو القيود التي يفرضها جدار حماية الشبكة
تشير الرسالة "ERR_NAME_NOT_RESOLVED" إلى أنّ عنوان URL للخادم الوكيل SmartDocs تم ضبطه بشكل غير صحيح أو أنّ الشبكة التي يتم من خلالها الوصول إلى البوابة لا يمكنها إجراء طلب إلى عنوان URL للخادم الوكيل SmartDocs بسبب القيود التي يفرضها جدار الحماية. يجب أن يكون الخادم الوكيل SmartDocs متاحًا من الإنترنت أو من الشبكة الداخلية (بالنسبة إلى واجهات برمجة التطبيقات الداخلية).
الدقة
تأكَّد من إمكانية الوصول إلى الخادم الوكيل SmartDocs من جميع الشبكات المطلوبة من خلال نشر الخادم الوكيل SmartDocs على مضيف افتراضي على Edge باستخدام اسم مضيف يمكن الوصول إليه من الإنترنت.
تم ضبط البوابة على بروتوكول HTTPS، وطلب SmartDocs على بروتوكول HTTP
يشير الخطأ "محتوى مختلط" إلى أنّه يتم استدعاء الخادم الوكيل SmartDocs عبر بروتوكول HTTP من صفحة تم تحميلها عبر بروتوكول HTTPS.
الدقة
اعرض الخادم الوكيل SmartDocs عبر بروتوكول HTTPS لحلّ المشكلة. يمكنك إجراء ذلك من خلال نشر الخادم الوكيل SmartDocs لتضمين مضيف افتراضي تم ضبطه لاستخدام بروتوكول أمان طبقة النقل (TLS) أو بروتوكول المقابس الآمنة (SSL) (عادةً ما يكون المضيف الافتراضي "آمن").
الخادم الوكيل SmartDocs الذي يعرض استثناءً
يمكن أن تحدث رسالة الخطأ 500 - خطأ في الخادم الداخلي بسبب مشكلة في الخادم الوكيل "smartdocs". في هذه الحالة، ستلاحظ أنّ الخادم الوكيل SmartDocs يعرض هذا الخطأ.
التشخيص
استخدِم أداة التتبُّع لتشخيص الأخطاء في الخادم الوكيل "smartdocs"، كما هو موضّح أدناه. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام أداة التتبُّع.
- فعِّل التتبُّع للخادم الوكيل "smartdocs" في مؤسسة "VALIDATE" لتحديد السياسة المحدّدة التي تعرض الخطأ "500 Internal Server Error".
- اختَر السياسة المحدّدة في التتبُّع لتحديد سبب الخطأ.
الدقة
أصلِح الخطأ الذي تم تحديده. إذا كنت بحاجة إلى مساعدة، تواصَل مع فريق دعم Apigee Edge.
لا يمكن لمعالِجات رسائل Edge استدعاء نقطة نهاية واجهة برمجة التطبيقات المنشورة
يمكن أن يحدث الخطأ "500 - Internal Server Error" أيضًا عندما لا تتمكّن معالِجات الرسائل التابعة للـ مؤسسة التي تستضيف الخادم الوكيل SmartDocs من استدعاء نقطة نهاية واجهة برمجة التطبيقات.
التشخيص
استخدِم أداة التتبُّع لتشخيص الأخطاء في الخادم الوكيل "smartdocs"، كما هو موضّح أدناه. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام أداة التتبُّع.
- فعِّل التتبُّع للخادم الوكيل “smartdocs” في مؤسسة “VALIDATE” لتحديد السياسة المحدّدة التي تعرض الخطأ "500 Internal Server Error".
- في نموذج تتبُّع واجهة المستخدم الموضّح أعلاه، يظهر أنّ سياسة JavaScript “BuildTargetAPIRequest” لا تتمكّن من تنفيذ عنوان URL المستهدَف.
- احصل على عنوان URL المستهدَف من سياسة JavaScript “BuildTargetAPIRequest”.
- أجرِ طلبًا مباشرًا إلى عنوان URL من عُقد معالِج الرسائل المرتبطة بمؤسسة
“VALIDATE” كما هو موضّح أدناه:
curl -v <target URL>
- أصلِح أي خطأ تم رصده.
الدقة
- تأكَّد من إمكانية استدعاء واجهات برمجة التطبيقات المنشورة على "بوابة المطوّرين" من معالِجات الرسائل المرتبطة بمؤسسة "VALIDATE" وأصلِح أي أخطاء يتم رصدها.
- إذا كان بإمكانك تنفيذ طلب بيانات من واجهة برمجة التطبيقات مباشرةً من معالِج الرسائل، فمن المرجّح جدًا أن تتمكّن من تنفيذ واجهة برمجة التطبيقات من خلال SmartDocs أيضًا.
- نفِّذ طلب واجهة برمجة التطبيقات من خلال SmartDocs وتحقَّق مما إذا تم حلّ المشكلة.