Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Belirti
Geliştirici portalından SmartDocs kullanılarak canlı API isteği gönderilirken hatayla karşılaşıldı.
Hata mesajları
Geliştirici Portalında görülen yaygın hata "Dahili bir hata oluştu. Lütfen isteğinizi tekrar deneyin" mesajını görüyorsanız.
Olası nedenler
Bu hata, Geliştirici Portalı arka uçtan (smartdocs 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ı belirlemek için ağ sekmesini kontrol edin.
Sık karşılaşılan hatalar ve bunların tipik nedenleri aşağıdaki tabloda listelenmiştir:
|
Hata |
Tipik Nedenler |
|
ERR_NAME_NOT_RESOLVED |
Smart Dokümanlar proxy'si yanlış yapılandırılmış veya ağ güvenlik duvarı kısıtlamaları |
|
Karma içerik |
Portal, HTTPS üzerinden yapılandırılmış, SmartDocs isteği HTTP üzerinden |
|
500 - Dahili Sunucu Hatası |
Bu nedenlerin her birini ve sorunu çözmek için gereken adımları tek tek inceleyelim.
Smart Docs 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 portala erişilen ağın güvenlik duvarı kısıtlamaları nedeniyle smartdocs proxy URL'sine çağrı yapamadığını gösterir. Smartdocs proxy'sine internetten veya dahili ağdan (dahili API'ler için) erişilebilmelidir.
Çözünürlük
Akıllı doküman proxy'sinin, internetten erişilebilen bir ana makine adıyla Edge'de bir sanal ana makineye dağıtılarak gerekli tüm ağlardan erişilebildiğinden emin olun.
HTTPS üzerinden yapılandırılmış portal, HTTP üzerinden SmartDocs isteği
"Karma İçerik" hatası, HTTPS üzerinden yüklenen bir sayfadan HTTP üzerinden akıllı doküman proxy'sinin çağrıldığını gösterir.
Çözünürlük
Sorunu çözmek için smartdocs proxy'yi https üzerinden kullanıma sunun. Bunu, TLS/SSL kullanacak şekilde yapılandırılmış bir sanal ana makine içerecek şekilde smartdocs proxy'sini dağıtarak yapabilirsiniz (genellikle "güvenli" sanal ana makine).
SmartDocs proxy'si istisna döndürüyor
500 - Dahili Sunucu Hatası mesajı, "smartdocs" proxy'siyle ilgili bir sorundan kaynaklanabilir. Bu durumda, akıllı doküman proxy'sinin bu hatayı döndürdüğünü görürsünüz.
Teşhis
Aşağıda açıklandığı gibi, "smartdocs" proxy'sindeki hataları 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 "VALIDATE" kuruluşunda "smartdocs" proxy'si için izlemeyi etkinleştirin.
- Hataya neden olan politikayı belirlemek için izlemede ilgili politikayı seçin.
Çözünürlük
Belirlenen hatayı düzeltin. Yardıma ihtiyacınız varsa Apigee Edge Destek Ekibi ile iletişime geçin.
Edge Message Processors, yayınlanan API uç noktasını çağıramıyor
500 - Internal Server Error (Dahili Sunucu Hatası), Smartdocs proxy'sine ev sahipliği yapan kuruluşa ait ileti işlemcileri API uç noktasını çağıramadığında da oluşabilir.
Teşhis
Aşağıda açıklandığı gibi, "smartdocs" proxy'sindeki hataları 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 "VALIDATE" kuruluşundaki "smartdocs" proxy'si için izlemeyi etkinleştirin.
- Yukarıda gösterilen örnek kullanıcı arayüzü izinde, JavaScript politikası "BuildTargetAPIRequest"in hedef URL'yi yürütmekte başarısız olduğu görülüyor.
- Hedef URL'yi JavaScript politikasından “BuildTargetAPIRequest” ile alın.
- Aşağıda gösterildiği gibi, "VALIDATE" kuruluşuyla ilişkili Mesaj İşleyici düğümlerinden URL'ye doğrudan çağrı yapın:
curl -v <target URL>
- Görülen hataları düzeltin.
Çözünürlük
- Geliştirici portalında yayınlanan API'lerin, "VALIDATE" kuruluşuyla ilişkili mesaj işlemcilerinden çağrılabildiğinden emin olun ve karşılaşılan hataları düzeltin.
- API çağrısını doğrudan Mesaj İşleyici'den yürütebiliyorsanız API'yi SmartDocs üzerinden de yürütebilmeniz çok olasıdır.
- API çağrısını SmartDocs üzerinden yürütün ve sorunun düzeltilip düzeltilmediğini kontrol edin.