מידע על Cloud Endpoints

‫Endpoints היא מערכת מבוזרת לניהול API. הוא כולל מסוף API, אירוח, רישום ביומן, מעקב ותכונות נוספות שיעזרו לכם ליצור ממשקי API, לשתף אותם, לתחזק אותם ולאבטח אותם. בדף הזה מובאת סקירה כללית על Cloud Endpoints for OpenAPI. למידע על סוגים אחרים של מסגרות API שנתמכות על ידי Endpoints, ראו כל המסמכים בנושא Endpoints.

אפשר להשתמש ב-Endpoints עם Extensible Service Proxy (ESP) מבוזר או עם Extensible Service Proxy V2‏ (ESPv2). כל שרת proxy מספק תמיכה בפלטפורמות שמתוארות בהמשך:

  • סביבה גמישה של App Engine (ב-ESP בלבד)
  • ‫Google Kubernetes Engine‏ (ESP או ESPv2)
  • ‫Compute Engine‏ (ESP או ESPv2)
  • ‫Kubernetes‏ (ESP או ESPv2)
  • App Engine standard (ESPv2 בלבד)
  • פונקציות Cloud Run (רק ESPv2)
  • ‫Cloud Run (ESPv2 בלבד)
  • מילוי בקשות מסוג Knative‏ (ESPv2 בלבד)

נקודות קצה עם ESP

‫Endpoints משתמש ב-Extensible Service Proxy‏ (ESP) מבוזר כדי לספק חביון נמוך וביצועים גבוהים גם עבור ממשקי API עם דרישות גבוהות. ‫ESP הוא פרוקסי שירות שמבוסס על NGINX, כך שאתם יכולים להיות בטוחים שהוא יתרחב לפי הצורך כדי לטפל בבקשות בו-זמניות ל-API שלכם. ‫ESP פועל בקונטיינר Docker משלו כדי לשפר את הבידוד והמדרגיות, והוא מופץ ב-Container Registry. אפשר להשתמש בו עם:

נקודות קצה עם ESPv2

‫ESPv2 הוא פרוקסי מבוסס Envoy, בעל ביצועים גבוהים וניתן להרחבה, שפועל מול קצה עורפי של OpenAPI או gRPC API. ‫ESPv2 תומך בגרסה 2 של מפרט OpenAPI ובמפרטים של gRPC. אפשר להשתמש בו עם:

תכונות לניהול ממשקי API של Endpoints

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

יומנים ומדדים

‫Endpoints משתמש ב-Service Infrastructure כדי לנהל ממשקי API ולדווח על יומנים ומדדים. רוב Google Cloud ממשקי ה-API מבוססים על אותה תשתית. אפשר לנהל ולנטר את ממשקי ה-API בדף Endpoints Services במסוףGoogle Cloud .

אירוח API

‫Endpoints מותאם לסביבת קונטיינרים של Docker. אתם יכולים לארח את ה-API בכל מקום שבו Docker נתמך, כל עוד יש לו גישה לאינטרנט לכתובתGoogle Cloud.

פיתוח API בארכיטקטורת REST באמצעות Endpoints for OpenAPI

נקודות הקצה לא תלויות בשפה. אתם יוצרים את ה-API בכל שפה ובכל מסגרת REST שתומכות בתיאור API באמצעות קובץ תצורה של OpenAPI.

כדי להשתמש ב-Endpoints ל-OpenAPI, צריך:

  • הגדרת נקודות קצה: מתארים את המשטח של ה-API ומגדירים תכונות של נקודות קצה, כמו מפתחות API או כללי אימות, בקובץ הגדרה של OpenAPI.

  • פריסת הגדרות Endpoints: אחרי שמגדירים את ה-API בקובץ הגדרות OpenAPI, משתמשים ב-Google Cloud CLI כדי לפרוס אותו ב-Service Management, שמשמש את Endpoints לניהול ה-API. עכשיו Endpoints יודע הכול על ה-API שלכם ואיך לאבטח אותו.

  • פריסת השרת העורפי של ה-API: פורסים את ESP או ESPv2 ואת השרת העורפי של ה-API בשרת עורפי נתמך Google Cloud , כמו Compute Engine. ‫ESP מתאם עם שירותי ה-Backend של Endpoints כדי לאבטח את ה-API ולנטר אותו בזמן הריצה.

שליטה בגישה ל-API

באמצעות Endpoints אפשר להגדיר את ה-API כך שכל קריאה תדרוש מפתח API, ולבדוק את תקינות מפתח ה-API. אפשר גם להשתמש במסוף Google Cloud כדי לשתף את ה-API עם מפתחים אחרים, כדי שהם יוכלו להפעיל את ה-API וליצור מפתחות API כדי להפעיל אותו.

אימות משתמשי API

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

שימו לב ששרת ה-API עדיין צריך להחליט מה המשתמש המאומת יכול לעשות עם ה-API. מידע נוסף זמין בGoogle Cloud מדריך האימות.

המאמרים הבאים

  • כדי להכיר את שלבי הפריסה ולראות את התכונות של Endpoints בפעולה, אפשר לעבור על המדריך למתחילים של Endpoints, שכולל סקריפטים לפריסת API לדוגמה בשרת קצה עורפי גמיש של App Engine.

  • כדי לקבל מידע נוסף על שימוש בנקודות קצה, אפשר לעיין באחד מהמדריכים.