הסבר על ממשקי API ושרתי API

אתה צופה בתיעוד של Apigee Edge.
הצג תיעוד של Apigee X.

ב-Apigee Edge אפשר ליצור בקלות ובמהירות ממשקי API ל-REST, שמפתחי אפליקציות יכולים לצרוך. חשיפת ממשקי API ב-Edge על ידי בניית שרתי proxy שמשמשים כ 'חזית' מנוהלת של שירותים לקצה עורפי. הנושא הזה דן בקשר בין ממשקי API ושרתי proxy של API ב-Apigee Edge.

סרטון: מומלץ לצפות בסרטון הקצר הזה כדי להכיר את שרתי ה-API של ה-API.

מה זה API?

ממשק API הוא ממשק שעוזר לאפליקציה אחת לצרוך יכולות או נתונים מאפליקציה אחרת. ממשק ה-API מאפשר להגדיר נקודות כניסה יציבות ופשוטות יותר ללוגיקה ולנתונים של האפליקציה, וכך מאפשר למפתחים לגשת בקלות ללוגיקת אפליקציות של מפתחים אחרים ולעשות בה שימוש חוזר. במקרה של 'ממשקי API באינטרנט', הלוגיקה והנתונים האלה נחשפים ברשת.

אפליקציות שצורכות ממשקי API הן רגישות לשינויים, ולכן ממשקי API רומזים גם על 'חוזה'. החוזה מספק רמה מסוימת של ביטחון, שעם הזמן ה-API ישתנה באופן צפוי.

ב-Apigee Edge אפשר ליצור ממשקי API, ואם כבר יש לכם ממשקי API, תוכלו לחשוף אותם ישירות תוך כדי הוספה של שכבת ניהול וחשיפה. אם יש לכם שירותים התומכים ב-HTTP, כמו שירותי אינטרנט המבוססים על SOA, הם יכולים להיחשף גם כממשקי API דרך Apigee Edge.

Edge גם מאפשר ליצור ממשקי API על ידי הטמעת אפליקציות שמתארחות בפלטפורמת שירותי ה-API ללא צורך בקצה עורפי. תוכלו ליצור את האפליקציות האלה ב-JavaScript, ב-Java וב-Node.js.

מהו שרת proxy של API?

כדי לחשוף ממשקי API ב-Apigee Edge, מטמיעים שרתי proxy של API. שרתי proxy של API מפרידים את ממשק ה-API הפונה לאפליקציה משירותי הקצה העורפי שלך, ומגינים על האפליקציות האלה מפני השינויים בקוד הקצה העורפי. כשמבצעים שינויים בקצה העורפי בשירותים, האפליקציות ימשיכו לקרוא לאותו API בלי הפרעה.

בהגדרה של שרת proxy ל-API, יש שני סוגים של נקודות קצה:

  • ProxyEndpoint:האופן שבו אפליקציות של לקוחות צורכות את ממשקי ה-API שלכם. ההגדרה של ProxyEnd היא הגדרה של כתובת ה-URL של שרת ה-API. נקודת הקצה של שרת ה-proxy גם קובעת אם אפליקציות ניגשות לשרת ה-API של ה-API באמצעות HTTP או HTTPS. בדרך כלל צריך לצרף מדיניות ל-ProxyEndpoint כדי לאכוף אבטחה, בדיקות מכסה וסוגים אחרים של בקרת גישה והגבלת קצב של יצירת בקשות.
  • TargetEndpoint: מגדיר את האופן שבו שרת ה-API מקיים אינטראקציה עם השירותים לקצה העורפי. עליך להגדיר את נקודת הקצה (endpoint) להעברת בקשות לשירות הקצה העורפי, כולל הגדרות אבטחה, פרוטוקול HTTP או HTTPS ופרטי חיבור אחרים. ניתן לצרף כללי מדיניות ל-TargetEndpoint כדי לוודא שהפורמט של הודעות התגובה לאפליקציה שממנה נשלחה הבקשה הראשונית.

הצגה חזותית של שרתי proxy של API, כפי שמוצג בתרשים הבא:

בקשות HTTP שמועברות דרך נקודת הקצה של בקשת שרת ה-proxy, מועברות לנקודת הקצה של בקשת היעד ונשלחות אל השירותים לקצה העורפי. תגובות HTTP נכנסות דרך נקודת הקצה של יעד התגובה, מועברות לנקודת הקצה של התגובה לשרת ה-proxy ואחר כך נשלחות ללקוח.

איך יוצרים שרת proxy ל-API?

שרת proxy ל-API מורכב מחבילה של קובצי תצורה וקוד XML (כמו JavaScript ו-Java). ב-Apigee יש כמה דרכים ליצור שרתי proxy של API, כולל:

  • שימוש בממשק המשתמש לניהול Edge כדי להגדיר שרת proxy של API בממשק משתמש גרפי (GUI). מידע נוסף זמין במאמר יצירת שרת proxy פשוט ל-API.
  • יצירת קובצי XML, יחד עם כל קובץ תומך אחר, שמגדיר את שרת ה-proxy של ממשק ה-API ולאחר מכן מייבאת אותם אל Edge.
  • שימוש בממשק ה-API לניהול של Edge כדי ליצור שרתי proxy דרך API על ידי שליחת סדרה של בקשות REST ל-Edge.
  • פריסת אפליקציה Node.js כ-proxy. מומלץ לקרוא את המאמר פריסת אפליקציה עצמאית ב-Node.js.

מהי מדיניות?

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

יצירת שרת proxy ראשון ל-API

ב-Apigee יש קבוצה של מדריכים שאפשר להשתמש בהם כדי ליצור את ה-API הראשון. בשלב הראשון צריך ליצור את שרת ה-API הראשון של ה-API.

דרך מצוינת ללמוד על שרתי proxy של API היא לעבוד עם הדוגמאות כמו שמתואר בקטע שימוש בשרתי proxy של API לדוגמה.

מידע נוסף