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