עיצוב ועריכה של ממשקי API

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

בדף הזה מוסבר איך לעצב ולערוך ממשקי API ב-Apigee ב-Cloud Code.

לפני שמתחילים

לפני שמשתמשים בפונקציונליות שבמדריך הזה, צריך לוודא שביצעתם את שלבי ההגדרה של הגדרת ניהול Apigee API ב-Cloud Code ל-VS Code, כולל לוודא שלחשבון המשתמש שלכם יש את התפקידים הנדרשים שמפורטים במאמר תפקידים שנדרשים לשימוש במרכז Apigee API עם פיתוח מקומי של Apigee.

ממשקי API לעיצוב

אפשר להוסיף ולערוך פרוקסי של Apigee API ו-API של API Hub ישירות ב-Cloud Code.

• יוצרים proxy ל-API ב-Apigee לפי השלבים במאמר יצירת proxy ל-API.
• כדי ליצור API של API Hub, לוחצים על סמל הפלוס בשורה של המארח של API Hub. ייפתח חלון לעריכת המפרט וחלונית Swagger של מפרט ה-API החדש, ותוכלו לפרסם את ה-API במרכז ה-API.

כדאי לדעת: אפשר גם להשתמש בצ'אט של Gemini Code Assist כדי ליצור מפרט של OpenAPI ואז להעתיק אותו לשימוש ב-Apigee. מידע נוסף זמין במאמר כתיבת קוד באמצעות Gemini Code Assist Standard ו-Enterprise. אחרי ההגדרה, מזינים הנחיה כמו

Create an OpenAPI spec for an API that lets customers schedule appointments with a dental office.

המפרטים שנוצרים בדרך הזו לא כוללים הקשר ארגוני ממרכז ה-API.

עריכת ממשקי API

אתם יכולים לערוך ממשקי API ששמרתם באופן מקומי או מקטלוג מרכז ה-API. אפשר לפרסם ב-API Hub את השינויים שמבצעים ב-Cloud Code, או לשמור אותם כחבילת proxy ל-API של Apigee.

לא משנה באיזו שיטה משתמשים כדי לערוך API, אפשר לעדכן את המפרט באופן ידני או להשתמש ב-Gemini Code Assist Chat (אם הוא מופעל) כדי לבצע איטרציה על המפרט. שימו לב: כשמשתמשים ב-Gemini Code Assist Chat כדי לבצע איטרציה על המפרט, ההצעות של Gemini Code Assist לא כוללות הקשר ארגוני ממרכז ה-API.

עריכה של מפרט API ממרכז ה-API

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

1. מוודאים שהפרויקט שבחרתם ב-Cloud Code הוא הפרויקט שבו נמצא קטלוג מרכז ה-API שמכיל את ה-API שרוצים לערוך.
2. בחלונית הניווט הימנית, מרחיבים את העץ API Hub בקטע Apigee.
3. בוחרים את ה-API והגרסה שרוצים לערוך מהרשימה. יוצגו קובץ ה-YAML ותצוגת החלונית של Swagger עבור ה-API.

עריכת מפרט API שמאוחסן באופן מקומי

כדי לערוך מפרט API שמאוחסן באופן מקומי, פותחים את הקובץ ב-Cloud Code.

אם יצרתם חבילת proxy של Apigee מהמפרט, אתם יכולים לפתוח את קובץ חבילת ה-proxy ב-Cloud Code. לשם כך, לוחצים על שם ה-proxy ל-API בקטע apiproxies בסביבת העבודה של Apigee.

שמירת ממשקי API כחבילות של proxy ל-API

אתם יכולים לשמור את ה-API כחבילת שרת proxy ל-API של Apigee כדי שתוכלו לעבוד עליו בסביבת הפיתוח המקומית של Apigee. מידע על עבודה עם שרתי proxy ל-API ב-Cloud Code זמין במאמר בנושא פיתוח שרתי proxy ל-API.

1. לוחצים על Create API proxy bundle (יצירת חבילת proxy ל-API) בחלונית Swagger.
2. בשדה ההנחיה, נותנים שם ל-proxy ל-API וממשיכים.
3. proxy ה-API מופיע בתפריט הימני של Apigee בסביבת העבודה המקומית, בקטע apiproxies.

פרסום ממשקי API ב-API Hub

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

1. בחלונית Swagger של מפרט API חדש או ערוך, לוחצים על Publish to API hub (פרסום במרכז ה-API).
2. בטופס, צריך לספק מטא-נתונים עבור ה-API כדי לשפר את יכולת הגילוי שלו ואת הארגון של ממשקי ה-API בקטלוג של מרכז ה-API. רוב השדות מאוכלסים אוטומטית מתוך מפרט ה-API, אבל אפשר לשנות את הערכים. במאמר הרשמה ל-API מוסבר איך להירשם ל-API Hub ואיזה מידע צריך לספק.
   • השם המוצג של ה-API (חובה): שם ה-API שמוצג למפתחים אחרים.
   • תיאור ה-API (אופציונלי): תיאור של ה-API לעיון פנימי או לעיון של מפתחים.
   • שם הבעלים של ה-API (אופציונלי): שם הבעלים של ה-API.
   • כתובת האימייל של בעלי ה-API (אופציונלי): כתובת האימייל של הבעלים.
   • ‫API Version (גרסת ה-API) (חובה): גרסת ה-API.
   • שלב במחזור החיים (אופציונלי): בוחרים שלב מהרשימה.
3. לוחצים על פרסום כדי לפרסם את ה-API במרכז ה-API.
4. אחרי השהיה קצרה, השינויים אמורים להופיע בעץ API Hub בקטע Apigee ב-Cloud Code.

בדיקת ממשקי API באמצעות שרת מדומה

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

שימוש בשרת מקומי להדמיה

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

בנוסף, שרתי הדמיה מקומיים:

• לא פועל כשמשתמשים ב-Cloud Shell Editor או ב-Cloud Workstations.
• יכול להיות שהתכונה לא תפעל בצורה תקינה כשמשתמשים ב-VS Code Remote Explorer.

כדי להשתמש בשרת המקומי לסימולציה:

1. בתפריט הנפתח Servers (שרתים), בוחרים את שרת הדמה המקומי (אם הוא עדיין לא נבחר):
   
2. פותחים נתיב בחלונית Swagger ולוחצים על Try it out (ניסיון).
   
3. ממלאים את הפרמטרים של הבקשה ולוחצים על Execute (ביצוע).
   

שימוש בשרת מוקה מרוחק

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

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

פריסה של Google Cloud שרת מוקה מרוחק יוצרת שירות חדש ב-Cloud Run. הוא יוצר קובץ אימג' של קונטיינר לשרת הדמה באמצעות Cloud Build ומעלה את קובץ אימג' של קונטיינר ל-Cloud Artifact Registry בפרויקט Google שלכם. אפשר לעיין במאמר מה זה Cloud Run?, ניהול שירותים, ומסמכי התיעוד של Artifact Registry.

אפשר להשתמש בחשבון השירות שמוגדר כברירת מחדל או לספק חשבון שירות עם הרשאות מוגבלות יותר כדי לפרוס את אפליקציית Cloud Run. מידע נוסף זמין במאמר ניהול של ממשקי Cloud API וספריות לקוח ב-Cloud ב-Cloud Code ל-VS Code.

חשוב: אתם אחראים לכל העלויות ולתחזוקה של שרת ה-mock המרוחק שנוצר. אתם גם אחראים למחוק אותו כשאין בו יותר צורך או כשלא משתמשים בו יותר. במחירון של Cloud Run מופיע מידע על התמחור, כולל מידע על אפשרויות של תוכנית בחינם.

כדי לפרוס שרת מדומה מרוחק:

1. בחלונית Swagger, בוחרים באפשרות Deploy mock server (פריסת שרת מדומה).
2. אם ה-API שלכם עדיין לא רשום במרכז ה-API, תתבקשו לרשום אותו.
3. מציינים את הפרטים של שרת הדמה המרוחק: שם השרת, שרת מאובטח, חשבון שירות (משאירים ריק כדי להשתמש בחשבון השירות שמוגדר כברירת מחדל) והאם להוסיף את כתובת ה-URL של השרת למפרט ה-API. לוחצים על יצירה כדי ליצור את שרת הדמה המרוחק.
   חשוב: אל תיצרו כמה שרתי סימולציה מרוחקים עם אותו שם, גם אם ממשק המשתמש לא ימנע מכם לעשות זאת בשלב הזה.
4. יצירת שרת מדומה מרוחק נמשכת כמה דקות. אפשר לעקוב אחרי ההתקדמות בחלונית OUTPUT של Cloud Code ובהודעה הקופצת בפינה השמאלית התחתונה של VS Code.
5. אחרי שתהליך היצירה של שרת הדמה המרוחק יסתיים, כתובת ה-URL של השרת המרוחק תופיע ברשימת השרתים בחלונית Swagger ובחלונית OUTPUT.
6. כדי להשתמש בשרת הדמה, פותחים נתיב ולוחצים על Try it out (התנסות).
   
   
   ממלאים את פרמטרים הבקשה ולוחצים על Execute (ביצוע).
   
   
   אפשר גם לשלוח בקשות באמצעות curl מהנחיה. משתמשים בכתובת השרת וביציאה מהתפריט הנפתח שרתים.

כדי לשתף גישה לשרת הדמה עם משתמשים אחרים:

1. נותנים למשתמשים אחרים את תפקיד המפעיל בשירות שנפרס. אימות מפתחים
2. כשמגישים בקשה לשרת הדמה, המשתמשים פועלים לפי ההוראות במאמר בדיקת השירות הפרטי.

כדי לנהל שרתי דמה מרוחקים שהופעלו:

1. עוברים אל Apigee API hub.
2. מחפשים את ה-API כדי לראות את כל הפריסות עבור ה-API, כולל כל שרתי ה-mock המרוחקים.
3. משתמשים בכתובת ה-URL של המשאב כדי לעבור לפריסה ולנהל אותה על ידי עצירה, מחיקה וביצוע פעולות אחרות בשרת הדמה.