M365Con 2027 – כנס אונליין חינמי · 11–22 Jan 2027 · 120 sessions m365con.net

API-first architecture

Concept

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

✦ CONCEPTAPI-first architectureM365.FM
Title graphic: API-first architecture (Concept)

נושאים שנדונים גם

בפרק על API-first architecture עולים גם: Computer-Using Agent (CUA), Foundry Agent Service, Service account, Agent observability, Microsoft Agent 365 ו-Software as a service (SaaS).

Description

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

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

הגישה מושווית לעיתים קרובות לפיתוח code-first. בגישה כזו ה-API צומח מתוך קוד קיים, ועלול לחשוף פרטים פנימיים בממשק הציבורי. API-first הופך את הסדר: הממשק מתוכנן בכוונה, והקוד נכתב כך שיענה לו. בעמוד של Microsoft מצוינים גם חסרונות. עבודה חוזה-ראשונה מוסיפה מאמץ סקירה מוקדם, ונקודת מבט code-first יכולה להיות סבירה לכלי פנימי מוקדם שבו הצרכנים מעטים והממשק צפוי להשתנות במהירות. העמוד הוא מאמר של ספק וכולל תוכן ספציפי ל-Azure.

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

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

פרק הפודקאסט של M365.FM "Computer-Using Agents: How CUA Could Transform SaaS" מקשר בין ארכיטקטורת API-first לבין מערכות אקולוגיות של סוכנים. הפרק קובע שמערכות אקולוגיות של סוכנים משגשגות כאשר מאמצים ארכיטקטורת API-first, משום שהיא מאפשרת לחבר סוכנים, מערכות ותהליכי עבודה בבהירות ובצפיות. הפרק מתאר APIs יציבים כעמוד השדרה של מערכות חכמות, וטוען שמפתחים יכולים להסתמך עליהם כדי לחדש בלי לחשוש משיבושים. הוא גם מצביע על הרחבתיות כיתרון, שעוזר לארגונים להסתגל לדרישות משתנות. במסגרת הזו, תכנון API-first נמצא לצד השקעה בתהליכי עבודה שסוכנים יכולים ליצור, לאוטומט ולהרחיב.

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

Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.

TypeConcept
KindArchitecture

Frequently asked questions

Questions marked with AI were written with AI from the facts on this page.

מה המשמעות של ארכיטקטורת API-first? (AI)

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

במה API-first שונה מ-code-first? (AI)

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

מדוע API-first רלוונטי לסוכני AI? (AI)

הפרק "Computer-Using Agents: How CUA Could Transform SaaS" קובע ש-APIs יציבים הם עמוד השדרה של מערכות חכמות ומאפשרים לחבר סוכנים, מערכות ותהליכי עבודה בבהירות ובצפיות. ניתן גם לשרת לקוחות סוכנים לצד לקוחות אינטרנט ומובייל באמצעות API יחיד מאחורי שער.

Glossary

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Experts and companies for this topic

Nobody has listed this topic yet. Add it to your profile.

Maintained by Mirko Peters (Microsoft MVP) · Last updated: