מוצג המסמך של Apigee Edge.
עוברים אל
מסמכי תיעוד של Apigee X. מידע
תיאור הבעיה
אירעה שגיאה בעת ביצוע בקשת API פעילה באמצעות SmartDocs מהמפתח בפורטל.
הודעות שגיאה
השגיאה הנפוצה שמופיעה בפורטל המפתחים היא "אירעה שגיאה פנימית. אפשר לנסות לשלוח את הבקשה שוב".
סיבות אפשריות
השגיאה הזו יכולה להתרחש כשפורטל המפתחים לא מקבל תשובה מהקצה העורפי (מסמכים חכמים או נקודת הקצה עצמה).
אבחון
מפעילים את 'כלים למפתחים' בדפדפן ובודקים את כרטיסיית הרשת כדי לזהות את השגיאה בפועל.
בטבלה הבאה מפורטות שגיאות נפוצות והסיבות האופייניות להן:
|
שגיאה |
סיבות אופייניות |
|
ERR_NAME_NOT_RESOLVED |
שרת proxy של SmartDocs הוגדר באופן שגוי או חומת אש ברשת הגבלות |
|
תוכן מעורב |
|
|
500 – שגיאת שרת פנימית |
נעבור על כל אחת מהסיבות האלה בנפרד, ונפרט את השלבים לפתרון הבעיה.
שרת proxy של SmartDocs הוגדר באופן שגוי או חומת אש ברשת הגבלות
ההודעה “ERR_NAME_NOT_RESOLVED” מציינת כתובת ה-URL של שרת ה-proxy של Smartdocs מוגדרת באופן שגוי או שהרשת שממנה מתבצעת גישה לפורטל לא ניתן לבצע קריאה לכתובת ה-URL של שרת ה-proxy של Smartdocs עקב הגבלות של חומת האש. המסמכים החכמים שרת ה-proxy חייב להיות נגיש מהאינטרנט או מהרשת הפנימית (לממשקי API פנימיים).
רזולוציה
מוודאים שאפשר לגשת לשרת ה-proxy של Smartdocs מכל הרשתות הנדרשות על ידי פריסה שרת ה-proxy של Smartdocs למארח וירטואלי ב-Edge עם שם מארח שניתן לגשת אליו מהאינטרנט.
פורטל מוגדר ב-HTTPS, בקשת SmartDocs ב-HTTP
השגיאה "תוכן מעורב" מציינת ששרת ה-proxy של Smartdocs מופעלת ב-HTTP מדף שנטען דרך HTTPS.
רזולוציה
חושפים שרת proxy של Smartdocs באמצעות https כדי לפתור את הבעיה. אפשר לעשות זאת באמצעות פריסת שרת proxy של Smartdocs לכלול מארח וירטואלי שמוגדר לשימוש ב-TLS/SSL. (בדרך כלל המארח הווירטואלי ה"מאובטח").
שרת proxy של SmartDocs מחזיר חריג
ההודעה 500 – שגיאת שרת פנימית עשויה לנבוע מבעיה ב בשרת ה-proxy 'smartdocs'. במקרה הזה, תראו ששרת ה-Proxy של Smartdocs מחזיר את שגיאה.
אבחון
שימוש בכלי המעקב כדי לאבחן שגיאות בשרת ה-proxy ל-smartdocs כפי שמתואר. שלמטה. למידע נוסף, ראו שימוש בכלי המעקב.
- הפעלת מעקב עבור שרת ה-proxy של smartdocs ב: בארגון VALIDATE כדי לאתר את המדיניות הספציפית החזרת השגיאה 500 Internal Server Error.
- בוחרים את המדיניות הספציפית במעקב כדי לזהות את הגורם לשגיאה.
רזולוציה
מתקנים את השגיאה שזוהתה. אם אתם צריכים עזרה, תוכלו לפנות לתמיכה של Apigee Edge.
מעבדי הודעות קצה לא יכולים לקרוא לנקודת קצה ל-API שפורסמה
500 - שגיאת שרת פנימית עשויה להתרחש גם כאשר מעבדי ההודעות השייכים בארגון שמארח את שרת ה-proxy של Smartdocs לא יכולים לקרוא לנקודת הקצה של ה-API.
אבחון
שימוש בכלי המעקב כדי לאבחן שגיאות בשרת ה-proxy ל-smartdocs כפי שמתואר. שלמטה. למידע נוסף, ראו שימוש בכלי המעקב.
- מפעילים את האפשרות Trace עבור Smartdocs. שרת proxy בארגון VALIDATE כדי לאתר את המדיניות הספציפית שמחזירה את השגיאה 500 Internal Server Error.
- בדוגמת המעקב אחר ממשק המשתמש המוצגת למעלה, ניתן לראות כי מדיניות JavaScript ההפעלה של כתובת ה-URL של היעד נכשלה בקטע BuildTargetAPIRequest.
- קבלת כתובת ה-URL של היעד מהמדיניות בנושא JavaScript "BuildTargetAPIRequest".
- ביצוע קריאה ישירה לכתובת ה-URL מהצמתים של מעבד ההודעות שמשויכים אל
הארגון VALIDATE כפי שמוצג בהמשך:
curl -v <target URL>
- מתקנים כל שגיאה שזוהתה.
רזולוציה
- מוודאים שמעבדי ההודעות יכולים להפעיל ממשקי API שפורסמו בפורטל המפתחים המשויך לארגון "VALIDATE" ומתקנים שגיאות, אם יש כאלה המערכת נתקלה בבעיה.
- אם מצליחים לבצע את הקריאה ל-API ישירות ממעבד ההודעות, שתהיה לך אפשרות להפעיל את ה-API גם דרך SmartDocs.
- מפעילים את הקריאה ל-API דרך SmartDocs ובודקים אם הבעיה נפתרה.