הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של Apigee Edge
ההגדרה של ProxyEndpoint קובעת את האופן שבו אפליקציות לקוח צורכות את ממשקי ה-API דרך Apigee. ה-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 וזמן התגובה של היעד, ידווח בנפרד במקום להיות מסוכם עבור כל נקודות הקצה של ה-proxy.
- פתרון בעיות מהיר יותר