אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
ההגדרה של ProxyEndpoint מגדירה את האופן שבו אפליקציות לקוח צורכות את ממשקי ה-API דרך Apigee Edge. ה-ProxyEndpoint מגדיר את כתובת ה-URL של שרת ה-proxy ל-API ואת אופן הפעולה של שרת ה-proxy: אילו כללי מדיניות להחיל, אילו נקודות קצה של יעד להפנות אליהן ואילו תנאים צריכים להתקיים כדי שכללי המדיניות או כללי ההפניה יופעלו.
בקיצור, הגדרת ProxyEndpoint מגדירה את כל מה שצריך לעשות כדי להטמיע API.
תבנית אנטי
ל-proxy ל-API יכול להיות נקודת קצה אחת או יותר של proxy. הגדרה של כמה ProxyEndpoints היא מנגנון קל ופשוט להטמעה של כמה ממשקי API בשרת proxy יחיד. כך אפשר לעשות שימוש חוזר במדיניות ו/או בלוגיקה עסקית לפני ואחרי הפעלת TargetEndpoint.
מצד שני, כשמגדירים כמה ProxyEndpoints ב-proxy ל-API יחיד, בסופו של דבר משלבים הרבה ממשקי API לא קשורים באותו ארטיפקט. הוא מקשה על קריאה, הבנה, ניפוי באגים ותחזוקה של שרתי proxy ל-API. כך נמנעת הפעולה העיקרית של שרתי proxy ל-API: לאפשר למפתחים ליצור ולתחזק ממשקי API בקלות.
השפעה
יכולות להיות כמה רכיבי ProxyEndpoint ב-proxy ל-API:
- קשה למפתחים להבין ולתחזק את ה-proxy ל-API.
- הסתרת נתונים ב-Analytics. כברירת מחדל, נתוני הניתוח נצברים ברמת ה-proxy. אין פירוט של המדדים לפי נקודת קצה של שרת proxy, אלא אם יוצרים דוחות בהתאמה אישית.
- מקשים על פתרון בעיות בשרתי proxy ל-API.
שיטה מומלצת
כשמטמיעים שרת proxy חדש ל-API או מעצבים מחדש שרת proxy קיים ל-API, כדאי לפעול לפי השיטות המומלצות הבאות:
- מטמיעים proxy ל-API עם ProxyEndpoint יחיד.
- אם יש כמה ממשקי API שמשתפים שרת יעד משותף או שדורשים את אותה לוגיקה לפני או אחרי הפעלת שרת היעד, כדאי להשתמש בתהליכים משותפים כדי להטמיע את הלוגיקה הזו בשרתי proxy שונים של API.
- אם יש כמה ממשקי API שחולקים נתיב בסיס משותף להתחלה, אבל יש להם סיומת שונה, משתמשים בתהליכים מותנים ב-ProxyEndpoint יחיד.
- אם קיים proxy ל-API עם כמה ProxyEndpoints ואין בו בעיות, לא צריך לבצע שום פעולה.
שימוש ב-ProxyEndpoint אחד לכל proxy ל-API מוביל ל:
- פרוקסי פשוטים יותר וקלים יותר לתחזוקה
- מידע טוב יותר ב-Analytics, כמו ביצועי ה-proxy וזמן התגובה של היעד, ידווח בנפרד במקום להיות מסוכם עבור כל ProxyEndpoints
- פתרון בעיות מהיר יותר