Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi
Apigee X. info
Gejala
Terjadi error saat membuat permintaan API langsung menggunakan SmartDocs dari portal developer.
Pesan Error
Error umum yang terlihat di Portal Developer adalah “Terjadi error internal. Coba lagi permintaan Anda”.
Kemungkinan Penyebab
Error ini dapat terjadi saat Developer Portal gagal mendapatkan respons dari backend (proxy smartdocs atau endpoint sebenarnya).
Diagnosis
Aktifkan “Alat developer” di browser Anda dan periksa tab jaringan untuk mengidentifikasi error yang sebenarnya.
Error umum dan penyebab biasanya tercantum dalam tabel berikut:
|
Error |
Penyebab Umum |
|
ERR_NAME_NOT_RESOLVED |
Proxy SmartDocs salah dikonfigurasi atau pembatasan firewall jaringan |
|
Konten Campuran |
Portal dikonfigurasi melalui HTTP, permintaan SmartDocs melalui HTTP |
|
500 - Error Server Internal |
Mari kita bahas satu per satu setiap penyebab ini dan langkah-langkah untuk mengatasi masalah tersebut.
Proxy SmartDocs salah dikonfigurasi atau ada pembatasan firewall jaringan
Pesan “ERR_NAME_NOT_RESOLVED” menunjukkan bahwa URL proxy smartdocs salah dikonfigurasi atau jaringan tempat portal diakses tidak dapat melakukan panggilan ke URL proxy smartdocs karena pembatasan firewall. Proxy smartdocs harus dapat diakses dari internet atau dari jaringan internal (untuk API internal).
Resolusi
Pastikan proxy smartdocs dapat diakses dari semua jaringan yang diperlukan dengan men-deploy proxy smartdocs ke host virtual di Edge dengan nama host yang dapat diakses dari internet.
Portal dikonfigurasi melalui HTTPS, permintaan SmartDocs melalui HTTP
Error “Mixed Content” menunjukkan bahwa proxy smartdocs dipanggil melalui HTTP dari halaman yang dimuat melalui HTTPS.
Resolusi
Mengekspos proxy smartdocs melalui https untuk menyelesaikan masalah. Anda dapat melakukannya dengan men-deploy proxy smartdocs untuk menyertakan host virtual yang dikonfigurasi untuk menggunakan TLS/SSL (biasanya host virtual “aman”).
Proxy SmartDocs menampilkan pengecualian
Pesan 500 - Internal Server Error dapat disebabkan oleh masalah pada proxy “smartdocs”. Dalam hal ini, Anda akan melihat bahwa proxy smartdocs menampilkan error ini.
Diagnosis
Gunakan alat Trace untuk mendiagnosis error pada proxy “smartdocs”, seperti yang dijelaskan di bawah. Untuk mengetahui informasi selengkapnya, lihat Menggunakan alat Trace.
- Aktifkan rekaman aktivitas untuk Proxy “smartdocs” di organisasi “VALIDATE” untuk menemukan kebijakan tertentu yang menampilkan Error Server Internal 500.
- Pilih kebijakan tertentu dalam rekaman aktivitas untuk mengidentifikasi penyebab error.
Resolusi
Perbaiki error yang teridentifikasi. Jika Anda memerlukan bantuan, hubungi Dukungan Apigee Edge.
Prosesor Pesan Edge tidak dapat memanggil endpoint API yang dipublikasikan
500 - Error Server Internal juga dapat terjadi saat Pemroses Pesan milik organisasi yang menghosting proxy Smartdocs tidak dapat memanggil endpoint API.
Diagnosis
Gunakan alat Trace untuk mendiagnosis error pada proxy “smartdocs”, seperti yang dijelaskan di bawah. Untuk mengetahui informasi selengkapnya, lihat Menggunakan alat Trace.
- Aktifkan trace untuk proxy “smartdocs” di org “VALIDATE” untuk menemukan kebijakan tertentu yang menampilkan Error Server Internal 500.
- Dalam rekaman aktivitas UI contoh yang ditampilkan di atas, terlihat bahwa kebijakan JavaScript “BuildTargetAPIRequest” gagal mengeksekusi URL target.
- Dapatkan URL target dari kebijakan JavaScript “BuildTargetAPIRequest”.
- Lakukan panggilan langsung ke URL dari node Message Processor yang terkait dengan
org “VALIDATE” seperti yang ditunjukkan di bawah:
curl -v <target URL>
- Perbaiki setiap kesalahan yang diamati.
Resolusi
- Pastikan API yang dipublikasikan di Portal Developer dapat dipanggil dari Pemroses Pesan yang terkait dengan organisasi “VALIDATE” dan perbaiki semua error yang ditemukan.
- Jika Anda dapat mengeksekusi panggilan API langsung dari Pemroses Pesan, kemungkinan besar Anda juga dapat mengeksekusi API melalui SmartDocs.
- Jalankan panggilan API melalui SmartDocs dan periksa apakah masalah sudah teratasi.