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