Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Belirti
Geliştirici portalından SmartDokümanlar kullanılarak canlı API isteği gönderilirken hatayla karşılaşıldı.
Hata mesajları
Geliştirici Portalı'nda sık karşılaşılan hata, "Dahili bir hata oluştu. Lütfen isteğinizi yeniden deneyin" hata mesajını alıyorum.
Olası Nedenler
Bu hata, Geliştirici Portalı arka uçtan (akıllı dokümanlar proxy'si veya gerçek uç nokta) yanıt alamadığında ortaya çıkabilir.
Teşhis
Tarayıcınızda "Geliştirici Araçları"nı etkinleştirin ve gerçek hatayı bulmak için ağ sekmesini kontrol edin.
Sık karşılaşılan hatalar ve tipik nedenleri aşağıdaki tabloda listelenmiştir:
|
Hata |
Tipik Nedenler |
|
ERR_NAME_NOT_RESOLVED |
SmartDokümanlar proxy yanlış yapılandırılmış veya ağ güvenlik duvarı kısıtlamaları |
|
Karma İçerik |
HTTP'ler üzerinden yapılandırılan bağlantı, HTTP üzerinden SmartDokümanlar isteği |
|
500 - Dahili Sunucu Hatası |
Bu nedenleri ve sorunu çözmeye yönelik adımları tek tek ele alalım.
SmartDokümanlar proxy'si yanlış yapılandırılmış veya ağ güvenlik duvarı kısıtlamaları
"ERR_NAME_NOT_RESOLVED" mesajı, Smartdocs proxy URL'sinin yanlış yapılandırıldığını veya portalın erişildiği ağın, güvenlik duvarı kısıtlamaları nedeniyle Smartdocs proxy URL'sine çağrı yapamadığını belirtir. Smartdocs proxy'sine internetten veya dahili ağdan (dahili API'ler için) erişilebilmelidir.
Çözünürlük
Smartdocs proxy'sini, internetten erişilebilen bir ana makine adına sahip Edge'de bir sanal ana makineye dağıtarak Smartdocs proxy'sine gerekli tüm ağlardan erişilebildiğinden emin olun.
Portal HTTPS üzerinden yapılandırılmış, HTTP üzerinden SmartDokümanlar isteği
"Karma İçerik" hatası, akıllı dokümanlar proxy'sinin HTTPS üzerinden yüklenen bir sayfadan HTTP üzerinden çağrıldığını belirtir.
Çözünürlük
Sorunu çözmek için https üzerinden Smartdocs proxy'sini kullanıma sunun. Bunun için Smartdocs proxy'sini, TLS/SSL (genellikle "güvenli" sanal ana makine) kullanacak şekilde yapılandırılmış bir sanal ana makine içerecek şekilde dağıtabilirsiniz.
SmartDokümanlar proxy'si bir istisna döndürüyor
500 - Dahili Sunucu Hatası mesajı, "smartdocs" proxy'siyle ilgili bir sorundan kaynaklanıyor olabilir. Bu durumda, Smartdocs proxy'sinin bu hatayı döndürdüğünü fark ediyorsunuz.
Teşhis
"Akıllı dokümanlar" proxy'siyle ilgili hataları aşağıda açıklandığı gibi teşhis etmek için İzleme aracını kullanın. Daha fazla bilgi için İzleme aracını kullanma başlıklı makaleyi inceleyin.
- 500 Dahili Sunucu Hatası döndüren politikayı bulmak için "DOĞRULA" kuruluşunda "akıllı dokümanlar" proxy'si için izlemeyi etkinleştirin.
- Hatanın nedenini belirlemek için izde ilgili politikayı seçin.
Çözünürlük
Tanımlanan hatayı düzeltin. Yardıma ihtiyacınız olursa Apigee Edge Destek Ekibi ile iletişime geçin.
Edge Mesaj İşleyicileri yayınlanan API uç noktasını çağıramıyor
500 - Smartdocs proxy'sini barındıran kuruluşa ait Mesaj İşleyicileri API uç noktasını çağıramadığında da Dahili Sunucu Hatası ortaya çıkabilir.
Teşhis
"Akıllı dokümanlar" proxy'siyle ilgili hataları aşağıda açıklandığı gibi teşhis etmek için İzleme aracını kullanın. Daha fazla bilgi için İzleme aracını kullanma başlıklı makaleyi inceleyin.
- 500 Dahili Sunucu Hatası döndüren belirli politikayı bulmak amacıyla "trace" kuruluşunda "trace" proxy'si için trace özelliğini etkinleştirin.
- Yukarıda gösterilen örnek kullanıcı arayüzü izlemesinde, "BuildTargetAPIRequest" JavaScript politikasının hedef URL'yi yürütemediği görülmektedir.
- "BuildTargetAPIRequest" JavaScript politikasından hedef URL'yi edinin.
- "DOĞRULA" kuruluşuyla ilişkili Mesaj İşleyici düğümlerinden URL'ye aşağıda gösterildiği gibi doğrudan bir çağrı yapın:
curl -v <target URL>
- Gözlemlenen hataları düzeltin.
Çözünürlük
- Geliştirici Portalı'nda yayınlanan API'lerin, "DOĞRULA" kuruluşuyla ilişkili Mesaj İşleyicilerinden çağrılabildiğinden emin olun ve karşılaşılan hataları düzeltin.
- API çağrısını doğrudan Mesaj İşleyiciden yürütebilirseniz büyük olasılıkla API'yi SmartDokümanlar aracılığıyla da yürütebilirsiniz.
- API çağrısını SmartDokümanlar ile yürütün ve sorunun düzelip düzelmediğini kontrol edin.