בדף הזה מוסברים ההבדלים בין Endpoints Frameworks בסביבה הרגילה של App Engine לבין Extensible Service Proxy (ESP), שמשמש ב-Cloud Endpoints עבור ממשקי API שמשתמשים ב-OpenAPI או ב-gRPC. מידע נוסף על האפשרויות של Endpoints זמין במאמר בחירת אפשרות של Endpoints.
סקירה כללית
Cloud Endpoints היא מערכת לניהול API שעוזרת לכם לאבטח, לנטר, לנתח ולהגדיר מכסות בממשקי ה-API שלכם באמצעות אותה תשתית שבה Google משתמשת לממשקי ה-API שלה. התכונות של ניהול API כוללות אימות, מפתחות API, מעקב, רישום ביומן ומעקב אחר נתונים, ללא קשר לטכנולוגיה שבה נעשה שימוש כדי להטמיע את ה-API. הפונקציונליות של ניהול API מסופקת באמצעות ESP או באמצעות Endpoints Frameworks.
Extensible Service Proxy
ב-Endpoints for OpenAPI וב-gRPC, בקשות API מועברות דרך Extensible Service Proxy, שמאמת מפתחות ואסימוני אימות ושולח אותות (מדדים ויומנים) באמצעות Service Control API. ההפרדה שמספק ESP מאפשרת לכם לכתוב את קוד ה-Backend של REST או gRPC בכל שפה, ולהשתמש ב-gRPC או בכל מסגרת שתומכת בתיאור API באמצעות OpenAPI.
APIs באמצעות OpenAPI: קצה העורפי של ה-API יכול לפעול בסביבה הגמישה של App Engine, ב-Google Kubernetes Engine (GKE), ב-Compute Engine, ב-Kubernetes או בפריסות מקומיות.
ממשקי API באמצעות gRPC: אפשר להריץ את השרת העורפי של ה-API ב-GKE, ב-Compute Engine, ב-Kubernetes או בפריסות מקומיות.
בקשה נשלחת בנתיב הבא:
- מתקבלת בקשה לקוד שלכם והיא נשלחת לספק שירותי האימייל.
- ESP שולח בקשת בדיקה ל-Service Control API.
- אם הגדרתם את ה-API כך שידרוש מפתח API או אימות, Service Control API בודק אם הבקשה מורשית ושולח תגובה בחזרה ל-ESP.
- אם הבקשה לא מאושרת, ספק ה-ESP דוחה אותה. אם הבקשה מורשית, היא מועברת לקוד ה-backend שלכם. בכל מקרה, ESP מתעד מידע על הבקשה.
התמחור של ניהול Endpoints API תלוי במספר הקריאות בחודש.
מסגרות של נקודות קצה
לשרתי קצה עורפיים של API שפועלים בסביבה הרגילה של App Engine, יש את Endpoints Frameworks שעוזר למפתחים להתחיל במהירות להפעיל API. Endpoints Frameworks הוא web framework, והוא חלופה ל-Python Flask או ל-Java Jersey. Endpoints Frameworks משולב עם Service Control API, כלומר קצה עורפי שמשתמש ב-Endpoints Frameworks לא צריך לפעול מאחורי Extensible Service Proxy.
אם הפעלתם את ניהול ה-API, בקשה נשלחת בנתיב הבא:
- בקשה לקוד מתקבלת ונשלחת למודול Endpoints Management בתוך Endpoints Frameworks.
- מודול ניהול נקודות הקצה שולח בקשת בדיקה ל-Service Control API.
- אם הגדרתם את ה-API כך שידרוש מפתח API או אימות, Service Control API בודק אם הבקשה מורשית ושולח תגובה בחזרה למודול Endpoints Management.
- אם הבקשה לא מורשית, מודול Endpoints Management דוחה את הבקשה. אם הבקשה מורשית, היא מועברת אל Endpoints Frameworks. בכל מקרה, המודול Endpoints Management רושם ביומן מידע על הבקשה.
- Endpoints Frameworks מנתב את הבקשה לקוד ה-backend.
אתם יכולים להשתמש ב-Endpoints Frameworks עם או בלי פונקציונליות של ניהול API. השימוש ב-Endpoints Frameworks ללא פונקציונליות של ניהול API מוצע ללא תשלום. החיוב על הפונקציונליות של ניהול API מתבצע בהתאם לדף התמחור של Endpoints.
Endpoints Frameworks נתמך רק בשירותים שפועלים בסביבה הרגילה של App Engine. ב-Compute Engine, ב-GKE, בסביבה גמישה של App Engine או בסביבות אחרות, השירותים צריכים לפעול מאחורי ESP.
אם השירות פועל מאחורי ESP, אפשר לכתוב את קוד ה-Backend בכל שפה ובכל מסגרת, כמו Python Flask, Java Jersey או Node.js Express. בסביבות כאלה, אין צורך להשתמש ב-Endpoints Frameworks לניהול API.
המאמרים הבאים
מידע על הוספת ניהול API:
מידע על הסרת ניהול API: