אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
בנושא הזה מפורטים כמה מאפיינים בסיסיים של שרתי proxy ל-API, וכן קישורים למידע נוסף.
ממשקי API הם נקודות כניסה שמאפשרות לאפליקציה אחת להשתמש ביכולות של אפליקציה אחרת. הטמעת שרתי proxy ל-API כדי ליצור ממשקי API
ב-Apigee Edge, כדי להטמיע שרת proxy ל-API, מגדירים את הלוגיקה של שרת ה-proxy ל-API כרצף של שלבים שפועלים בתגובה לבקשה מקוד הלקוח. כדי לחשוף שרת proxy של API ללקוחות, מגדירים נקודות קצה שכוללות כתובת URL עם נתיבי משאבים, פעולת HTTP, דרישות לגוף וכו'.
הוא נקרא שרת proxy של API, אבל מנקודת המבט של קוד הלקוח, הוא ה-API.
סקירה כללית על שרתי proxy ל-API זמינה במאמר הסבר על ממשקי API ושרתי proxy ל-API.
סידור רצף הלוגיקה של שרת proxy ל-API באמצעות תהליכים
בכל אפליקציה, הנתונים זורמים דרך האפליקציה בהתאם ללוגיקה של התנאים. ב-Apigee Edge, נתיב העיבוד מורכב מתהליכים. תהליך הוא רצף של שלבים (או 'שלבים') שמרכיבים את נתיב העיבוד של שרת proxy ל-API. תהליכים הם האופן שבו Apigee Edge מספק מקומות שבהם אפשר להחיל לוגיקה והתנהגות במקומות ספציפיים מהלקוח למשאב הקצה העורפי, ואז חזרה ללקוח.
מידע נוסף על תהליכים זמין במאמר שליטה באופן שבו שרת proxy מבצע תהליכים
הגישה לנתוני המצב מתבצעת דרך משתני תהליך שנוצרו על ידי שרתים proxy של API
לשרת proxy של API יש גישה למשתנים שמייצגים את מצב הביצוע. אפשר לגשת למשתנים האלה מתוך קובץ ה-XML שמגדיר את שרת ה-proxy ואת כללי המדיניות של ה-API. אפשר לגשת אליהם גם כשמרחיבים שרת proxy של API בשפה פרוצדוראלית, כמו Java, JavaScript או Python.
המשתנים האלה נשמרים ב-Apigee Edge. חלק מהפרמטרים קיימים כברירת מחדל, בדרך כלל כי הם נפוצים במה ששרתי proxy של API עושים (למשל, כי הם חלק מבקשת HTTP). אפשר גם ליצור משתנים משלכם כדי לעמוד בדרישות לוגיות.
מידע נוסף על משתנים זמין במאמר ניהול מצב שרת proxy באמצעות משתני תהליך.
אפשר להגדיר ששרתי proxy של API יפעלו באופן מותנה
בדומה לרוב שפות התכנות, בשרתים proxy של API אפשר להריץ קוד באופן מותנה. התנאים מבוססים בדרך כלל על מצב שרת ה-proxy של ה-API, שאליו אפשר לגשת באמצעות משתני תהליך. לדוגמה, אפשר להגדיר תנאי שבודק את סוכן המשתמש ולאחר מכן מעבד את הבקשה בהתאם.
מידע נוסף על ביצוע מותנה זמין במאמר משתני תהליך ותנאים.
את רוב הלוגיקה מטמיעים בשרת proxy ל-API באמצעות מדיניות
רוב הלוגיקה שמוסיפים לשרת proxy של API נארזת כמדיניות. מדיניות היא רכיב של Apigee Edge שמכיל לוגיקה לאזור פונקציונלי, כמו אבטחה או ניהול תעבורה. מגדירים מדיניות עם XML שמגדיר מאפיינים לצורך הלוגיקה הבסיסית. אתם יכולים לארגן את כללי המדיניות ברצף של 'שלבים' בתוך תהליך, כדי ששרת ה-API המחובר לשרת proxy יבצע את הלוגיקה בסדר הטוב ביותר ליעדים של שרת ה-proxy.
מידע נוסף על כללי מדיניות זמין במאמר מהי מדיניות?
אפשר לכלול קבוצות של פונקציונליות לשימוש חוזר
כששרת ה-API המחובר כולל לוגיקה שתשמש במספר מקומות בקוד – כמו שרתי API אחרים – אפשר לאסוף את הלוגיקה הזו לקריאות ממספר מקומות. לדוגמה, אפשר לקבץ לוגיקה של אבטחה בתהליך משותף ששרתי proxy אחרים ל-API קוראים אליו, וכך לצמצם את הכפילויות בין שרתי ה-proxy ל-API.
מידע נוסף על תהליכי עבודה משותפים זמין במאמר תהליכי עבודה משותפים לשימוש חוזר. מידע נוסף על שרשרת של שרתים proxy ל-API זמין במאמר שרת proxy ל-API בשרשרת.
אפשר לנפות באגים בשרת proxy באמצעות הכלי Trace
Apigee Edge כולל כלי Trace שבעזרתו אפשר לבדוק את תהליך הביצוע של שרת ה-API במהלך ניפוי באגים ובדיקות. בכלי מוצג באופן חזותי כל שלב של שרת proxy ל-API שמתבצע עבור בקשה. כמו בכלי לניפוי באגים, בכל שלב אפשר לראות את רשימת ערכי המשתנים שמרכיבים את המצב של שרת ה-proxy של ה-API.
מידע נוסף על ניפוי באגים באמצעות Trace זמין במאמר שימוש בכלי Trace.
טיפול בשגיאות של שרת proxy ל-API ככשלים
הגדרת טיפול בשגיאות מאפשרת להתאים אישית את השגיאה שתוחזר ללקוח API. טיפולי השגיאות מאפשרים לכם לשלוט בהודעות השגיאה, בין אם השגיאה נובעת מהקוד שלכם ובין אם היא נובעת מרכיב כלול (כמו מדיניות).
מידע נוסף זמין במאמר טיפול בכשלים.