אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
בעזרת Apigee Edge אפשר ליצור בקלות ובמהירות ממשקי API מסוג RESTful שזמינים לשימוש של מפתחי אפליקציות. כדי לחשוף ממשקי API ב-Edge, יוצרים שרתי proxy ל-API שמשמשים כ 'חזיתות' מנוהלות של שירותי קצה עורפי. בנושא הזה נסביר על הקשר בין ממשקי API לבין שרתי proxy ל-API ב-Apigee Edge.
סרטון: סרטון קצר עם מבוא לשרתי proxy ל-API.
מהו API?
ממשק API הוא ממשק שמאפשר לאפליקציה אחת 'לצרוך' בקלות יכולות או נתונים מאפליקציה אחרת. ממשקי API מאפשרים למפתחים לגשת בקלות ללוגיקה של אפליקציות ולנתונים שלהן, ולהשתמש בהם מחדש, על ידי הגדרת נקודות כניסה פשוטות ויציבות ללוגיקה ולנתונים של האפליקציות. במקרה של ממשקי Web API, הלוגיקה והנתונים האלה נחשפים ברשת.
מכיוון שאפליקציות שמשתמשות בממשקי API רגישות לשינויים, ממשקי API כוללים גם 'חוזה'. החוזה מספק רמה מסוימת של ביטחון שעם הזמן ה-API ישתנה באופן צפוי.
בעזרת Apigee Edge אפשר ליצור ממשקי API, ואם כבר יש לכם ממשקי API, תוכלו לחשוף אותם ישירות תוך הוספת שכבת ניהול ותצוגה. אם יש לכם שירותים שפועלים באמצעות HTTP, כמו שירותי אינטרנט מבוססי SOA, תוכלו לחשוף אותם גם כ-API דרך Apigee Edge.
ב-Edge אפשר גם ליצור ממשקי API על ידי הטמעת אפליקציות שמתארחות בפלטפורמת API Services, בלי שירות לקצה העורפי. אפשר לפתח את האפליקציות האלה ב-JavaScript, ב-Java וב-Node.js.
מהו שרת proxy ל-API?
כדי לחשוף ממשקי API ב-Apigee Edge, מטמיעים שרתי proxy ל-API. שרתים proxy של API מפרידים בין ה-API שמוצג לאפליקציה לבין שירותי הקצה העורפי, ומגינים על האפליקציות האלה מפני שינויים בקוד של הקצה העורפי. כשמבצעים שינויים בקצה העורפי של השירותים, האפליקציות ממשיכות לבצע קריאות לאותו ממשק API ללא הפרעה.
בהגדרה של שרת proxy ל-API יש שני סוגים של נקודות קצה:
- ProxyEndpoint: מגדיר את האופן שבו אפליקציות לקוח צורכות את ממשקי ה-API שלכם. מגדירים את ProxyEndpoint כדי להגדיר את כתובת ה-URL של שרת ה-proxy ל-API. נקודת הקצה של שרת ה-proxy קובעת גם אם האפליקציות יגשו לשרת ה-proxy של ה-API דרך HTTP או דרך HTTPS. בדרך כלל מחברים policies ל-ProxyEndpoint כדי לאכוף אבטחה, בדיקות מכסות וסוגים אחרים של בקרת גישה ומגבלות קצב.
- TargetEndpoint: מגדיר את האופן שבו שרת ה-proxy ל-API יוצר אינטראקציה עם שירותי הקצה העורפי. מגדירים את TargetEndpoint כך שיעביר בקשות לשירות הקצה העורפי המתאים, כולל הגדרת הגדרות האבטחה, פרוטוקול HTTP או HTTPS ומידע נוסף על החיבור. אפשר לצרף policies ל-TargetEndpoint כדי לוודא שהפורמט של הודעות התגובה יהיה מתאים לאפליקציה ששלחה את הבקשה הראשונית.
אפשר להציג שרתי proxy ל-API כפי שמוצג באיור הבא:
איך יוצרים שרת proxy ל-API?
שרת proxy של API מורכב מחבילה של קובצי תצורה וקוד של XML (כמו JavaScript ו-Java). ב-Apigee יש כמה דרכים ליצור שרתים proxy ל-API, כולל:
- שימוש בממשק המשתמש לניהול של Edge כדי להגדיר שרת proxy ל-API בממשק משתמש גרפי (GUI). מידע נוסף זמין במאמר יצירת שרת proxy פשוט של API.
- יוצרים קובצי XML, יחד עם קובצי תמיכה אחרים, שמגדירים את שרת ה-proxy של ה-API, ולאחר מכן מייבאים אותם ל-Edge.
- שימוש ב-Edge Management API כדי ליצור שרתי proxy ל-API באמצעות שליחת סדרה של בקשות REST ל-Edge.
- פריסת אפליקציית Node.js כשרתי proxy. מידע נוסף זמין במאמר פריסה של אפליקציית Node.js נפרדת.
מהי מדיניות?
באמצעות policies, Edge מאפשר לכם לשלוט בהתנהגות של ממשקי API בלי לכתוב קוד. מדיניות היא כמו מודול שמטמיע פונקציית ניהול ספציפית ומוגבלת כחלק מתהליך הבקשה/התשובה של שרת ה-proxy. המדיניות נועדה לאפשר לכם להוסיף בקלות ובאופן מהימן סוגים נפוצים של יכולות ניהול ל-API. כללי המדיניות מספקים תכונות כמו אבטחה, הגבלת קצב, טרנספורמציה ותכונות תיווך, כך שאתם לא צריכים לכתוב קוד ולתחזק את הפונקציונליות הזו בעצמכם.
יצירת שרת ה-proxy הראשון של API
ב-Apigee יש קבוצה של מדריכים שבעזרתם תוכלו ליצור את ה-API הראשון שלכם. מומלץ להתחיל במאמר יצירת שרת proxy API ראשון.
דרך מצוינת ללמוד על שרתי proxy ל-API היא לעבוד עם הדוגמאות כפי שמתואר במאמר שימוש בדוגמאות של שרתי proxy ל-API.