> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ניהול ושימוש באינטגרציות מותאמות אישית

> חברו APIs משותפים פעם אחת והשתמשו בהם שוב בכל אפליקציה באזור העבודה שלכם.

אינטגרציות אזור עבודה מאפשרות לכם לרשום APIs חיצוניים משותפים ברמת אזור העבודה ממפרט OpenAPI. אתם מייבאים מפרט (URL או JSON), בוחרים עד 30 פעולות, ומחברים את ה-API פעם אחת באזור העבודה שלכם. כל אפליקציה באזור העבודה הזה יכולה אז לקרוא לפעולות המאושרות דרך `base44.integrations.custom.call()`, במקום להגדיר חיבור משלה. זה עובד גם ל-APIs פנימיים וגם ל-APIs של שותפים שהצוות שלכם תלוי בהם.

<Frame caption="אינטגרציות באזור עבודה ב-Base44">
  <img src="https://mintcdn.com/base44/pXMR2fd6LoL4mN_A/images/intgs.png?fit=max&auto=format&n=pXMR2fd6LoL4mN_A&q=85&s=e3d535ce0a0ba4ac282d03c1059660d7" alt="Integrations in a workspace in Base44" width="1439" height="373" data-path="images/intgs.png" />
</Frame>

אינטגרציות אלה מתוכננות להיות מאובטחות ואמינות. headers רגישים של אימות מאוחסנים כסודות אזור עבודה מוצפנים ולעולם לא נשלחים בחזרה לדפדפן. בזמן ריצה, קריאות מועברות בצד-שרת עם הגנות מפני server side request forgery (SSRF), והגדרות headers של אזור עבודה גוברות כך שאפליקציות לא יכולות לעקוף אותן. עריכת אינטגרציה משתמשת במפרט המאוחסן ולא ב-URL החי, ושמירה חסומה אם headers נכשלים בטעינה כדי שלא תאבדו אותם בטעות.

<Warning>
  **חשוב:**

  * גישה לאינטגרציות אזור עבודה מוגבלת למנהלי ובעלי אזור עבודה בתוכנית **Builder** ומעלה.
  * כל חבר באזור העבודה יכול להשתמש באינטגרציית אזור עבודה קיימת באפליקציות שלהם, אפילו בתוכנית חינמית.
</Warning>

***

## הבנת אינטגרציות אזור עבודה

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

**אינטגרציות אזור עבודה שימושיות כשאתם רוצים:**

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

***

## יצירת אינטגרציה

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

<Note>
  **לפני שמתחילים:** ודאו שיש לכם גישה למפרט OpenAPI או Swagger תקף עבור ה-API שאתם רוצים להשתמש בו. תוכלו לארח אותו ב-URL ציבורי או להעתיק את ה-JSON.
</Note>

### שלב 1 | הוספת אינטגרציה חדשה

1. לחצו על שם אזור העבודה שלכם בפינה השמאלית העליונה של החשבון שלכם.
2. לחצו על **Settings**.
3. לחצו על **Integrations**.
4. לחצו על **New Integration**.
5. בחרו איך אתם רוצים לספק את מפרט ה-API שלכם:
   * **From URL:** הזינו את ה-URL הציבורי של קובץ OpenAPI או Swagger שלכם בשדה **OpenAPI Specification URL**, לדוגמה `https://api.example.com/openapi.json`.
   * **Paste JSON:** הדביקו את הגדרת ה-JSON המלאה של מפרט OpenAPI או Swagger שלכם בעורך.
6. לחצו על **Continue**.

<Frame caption="הוספת אינטגרציה מותאמת אישית באזור עבודה">
  <img src="https://mintcdn.com/base44/dZzytOu9j0oe_U9j/images/step1again.png?fit=max&auto=format&n=dZzytOu9j0oe_U9j&q=85&s=998a5ac6f68d97d2a6e7883276070548" alt="Adding a custom integration in a workspace" title="Adding a custom integration in a workspace" className="mx-auto" style={{ width:"67%" }} width="1186" height="976" data-path="images/step1again.png" />
</Frame>

### שלב 2 | בחירת endpoints לחשיפה

בחרו עד 30 endpoints לאינטגרציה שלכם.

**כדי לבחור endpoints:**

1. סקרו את רשימת ה-endpoints ש-Base44 מגלה מהמפרט שלכם. תוכלו להשתמש בתיבת החיפוש כדי למצוא נתיבים או פעולות ספציפיים לפי מתודה או שם נתיב.
2. סמנו את תיבות הסימון עבור ה-endpoints שאתם רוצים לחשוף לאזור העבודה שלכם.
3. לחצו על **Continue**.

<Frame caption="בחירת ה-endpoints לחשיפה עבור אינטגרציית אזור העבודה שלכם">
  <img src="https://mintcdn.com/base44/dZzytOu9j0oe_U9j/images/step2.png?fit=max&auto=format&n=dZzytOu9j0oe_U9j&q=85&s=2c9e579cce16c3c548443170416c9fc3" alt="Selecting the endpoints to expose for your workspace integration" title="Selecting the endpoints to expose for your workspace integration" className="mx-auto" style={{ width:"72%" }} width="1190" height="984" data-path="images/step2.png" />
</Frame>

### שלב 3 | הגדרת האינטגרציה שלכם

הגדירו את פרטי האינטגרציה שלכם, הגדירו את ה-URL הבסיסי והוסיפו headers מותאמים אישית שה-API שלכם צריך. ערכי headers רגישים נשארים מוגנים. headers נפוצים של אימות כגון `authorization`, `x-api-key`, `api-key`, `x-auth-token`, `x-access-token`, `x-secret-key`, `bearer`, `secret`, `password` ו-`credential` מטופלים תמיד כסודות. הערכים שלהם מאוחסנים כסודות אזור עבודה מוצפנים, לעולם לא נשלחים בחזרה לדפדפן, ומוצגים כ-"sensitive – delete to change" כשאתם עורכים את האינטגרציה.

**כדי להגדיר את האינטגרציה שלכם:**

1. הגדירו את הפרטים עבור האינטגרציה שלכם:
   * **Slug:** הזינו מזהה ידידותי ל-URL עבור האינטגרציה, לדוגמה `my-api`.
   * **Name:** הזינו את שם התצוגה שמופיע ברשימת אינטגרציות אזור העבודה שלכם.
   * **Description:** תארו מה האינטגרציה עושה כך שחברי הצוות ידעו מתי להשתמש בה.
   * **Base URL:** אשרו או עדכנו את ה-URL הבסיסי עבור ה-API שלכם.
2. אם ה-API שלכם דורש headers שצריכים להישלח עם כל בקשה, הוסיפו אותם בקטע **Custom Headers**:
   1. לחצו על **Add Header**.
   2. הזינו את שם ה-header, כגון `Authorization` או `X-API-Key`.
   3. הזינו את ערך ה-header, כגון מפתח ה-API או הטוקן שלכם.
   4. השתמשו באייקון הנראות כדי להסתיר או לחשוף את ערך ה-header לפי הצורך.
3. סקרו את רשימת ה-endpoints שנבחרו בתחתית הדיאלוג.
4. לחצו על **Create Integration**.

<Frame caption="הגדרת אינטגרציית אזור העבודה שלכם">
  <img src="https://mintcdn.com/base44/vGj5ZIaYUxXljz-f/images/configure.png?fit=max&auto=format&n=vGj5ZIaYUxXljz-f&q=85&s=56883c536d3042bc22ba14c5043ab207" alt="Configuring your workspace integration" className="mx-auto" style={{ width:"81%" }} width="1166" height="986" data-path="images/configure.png" />
</Frame>

***

## ניהול אינטגרציות אזור עבודה

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

### צפייה בפרטי אינטגרציה

1. לחצו על שם אזור העבודה שלכם בפינה השמאלית העליונה של החשבון שלכם.
2. לחצו על **Settings**.
3. לחצו על **Integrations**.
4. צפו באינטגרציה שאתם רוצים לבדוק והרחיבו את ה-endpoints.

### עריכת אינטגרציה

1. לחצו על שם אזור העבודה שלכם בפינה השמאלית העליונה של החשבון שלכם.
2. לחצו על **Settings**.
3. לחצו על **Integrations**.
4. לחצו על אייקון **More Actions** <Icon icon="ellipsis-vertical" /> בכרטיס האינטגרציה.
5. לחצו על **Edit**.
6. עדכנו את השדות שאתם צריכים ושמרו את השינויים שלכם.

<Frame caption="עריכת אינטגרציית אזור עבודה">
  <img src="https://mintcdn.com/base44/Gl7XCv8esPzAOeqF/images/editint.png?fit=max&auto=format&n=Gl7XCv8esPzAOeqF&q=85&s=ae8362746fc747c68c52a26b07d24e4f" alt="Editing a workspace integration" width="1445" height="462" data-path="images/editint.png" />
</Frame>

<Tip>
  אם אתם צריכים לחשוף endpoints נוספים מאותו API, שקלו ליצור אינטגרציה חדשה או לעדכן את הקיימת בהתבסס על איך אתם רוצים שאפליקציות ישתמשו בה.
</Tip>

### מחיקת אינטגרציה

1. לחצו על שם אזור העבודה שלכם בפינה השמאלית העליונה של החשבון שלכם.
2. לחצו על **Settings**.
3. לחצו על **Integrations**.
4. לחצו על אייקון **More Actions** <Icon icon="ellipsis-vertical" /> בכרטיס האינטגרציה.
5. לחצו על **Delete**.
6. לחצו על **Delete** שוב כדי לאשר שאתם רוצים להסיר אותה מאזור העבודה.

<Frame caption="מחיקת אינטגרציית אזור עבודה">
  <img src="https://mintcdn.com/base44/Gl7XCv8esPzAOeqF/images/deleteint.png?fit=max&auto=format&n=Gl7XCv8esPzAOeqF&q=85&s=926253d2eb08ecf5447ef69435a2a5c0" alt="Deleting a workspace integration" width="1460" height="459" data-path="images/deleteint.png" />
</Frame>

<Warning>
  **חשוב:** מחיקת אינטגרציית אזור עבודה יכולה לשבור אינטגרציות ברמת אפליקציה שתלויות בה. ודאו שאתם סוקרים אפליקציות פעילות לפני שאתם מסירים אינטגרציה משותפת.
</Warning>

***

## שאלות נפוצות

לחצו על שאלה למטה כדי ללמוד עוד על אינטגרציות אזור עבודה.

<AccordionGroup>
  <Accordion title="איך אני משתמש באינטגרציית אזור עבודה באפליקציה שלי?">
    לאחר שאתם יוצרים אינטגרציית אזור עבודה, כל אפליקציה חדשה שאתם בונים באזור העבודה הזה יכולה להשתמש בה.

    כשאתם יוצרים אפליקציה חדשה, Base44 בודקת את אינטגרציות אזור העבודה שלכם. אם אתם מזכירים את אחת מהמערכות הללו בהודעה הראשונה שלכם, היא משתמשת אוטומטית באינטגרציית אזור העבודה התואמת. לדוגמה, אם כבר הוספתם אינטגרציית GitHub API ואתם אומרים "Create an app based on my GitHub issues", Base44 משתמשת באינטגרציית GitHub שמוגדרת עבור אזור העבודה מבלי שתצטרכו לבחור אותה.

    תוכלו אז לסקור ולהתאים איך האפליקציה משתמשת באותה אינטגרציה מהגדרות האינטגרציות של האפליקציה.
  </Accordion>

  <Accordion title="מי יכול ליצור ולנהל אינטגרציות אזור עבודה?">
    כדי ליצור או לנהל אינטגרציות אזור עבודה, עליכם להיות בעלי או מנהלי אזור עבודה בתוכנית Builder ומעלה עם גישה לכרטיסיית **Integrations** בהגדרות אזור העבודה שלכם. אם אינכם רואים את כפתור **Add Integration** או אפשרויות העריכה, צרו קשר עם מנהל אזור העבודה ובקשו ממנו לעדכן את התפקיד שלכם או ליצור את האינטגרציה עבורכם.
  </Accordion>

  <Accordion title="מה קורה אם מפרט OpenAPI משתנה?">
    אם בעל ה-API מעדכן את המפרט ב-URL שהשתמשתם בו, הפרטים ש-Base44 קוראת ממנו יכולים להשתנות בפעם הבאה שאתם מעדכנים או יוצרים מחדש את האינטגרציה. כשאתם יודעים שהמפרט השתנה, סקרו את אינטגרציית אזור העבודה שלכם ובדקו שה-endpoints החשופים עדיין תואמים את מה שהאפליקציות שלכם מצפות.
  </Accordion>

  <Accordion title="האם ערכי headers מאוחסנים בצורה מאובטחת ומי יכול לראות אותם?">
    ערכי headers כגון מפתחות API וטוקנים מאוחסנים כחלק מתצורת אינטגרציית אזור העבודה. רק חברי צוות עם הרשאה לנהל אינטגרציות אזור עבודה יכולים לצפות או לערוך את הערכים האלה. השתמשו באייקון הנראות בשלב Configure כדי להסתיר ערכים על המסך כשאתם עובדים במרחבים משותפים.
  </Accordion>

  <Accordion title="האם אוכל להחזיק יותר מאינטגרציית אזור עבודה אחת לאותו API?">
    כן. ניתן ליצור מספר אינטגרציות אזור עבודה שמצביעות לאותו API חיצוני. לדוגמה, ייתכן שתיצרו אינטגרציות נפרדות לסביבות sandbox ופרודקשן, או לסטים שונים של endpoints שמשמשים אפליקציות שונות.
  </Accordion>

  <Accordion title="איך עליי לבצע רוטציה למפתחות API או סודות אחרים שמשמשים אינטגרציית אזור עבודה?">
    כשאתם צריכים לבצע רוטציה למפתח או טוקן, צרו תחילה את פרטי הכניסה החדשים במערכת החיצונית. ואז ערכו את אינטגרציית אזור העבודה, עדכנו את ערך ה-header הרלוונטי עם המפתח או הטוקן החדש ושמרו את השינויים שלכם. לאחר עדכון אינטגרציית אזור העבודה, אפליקציות שמשתמשות בה מתחילות לשלוח את הערך החדש אוטומטית.
  </Accordion>

  <Accordion title="מה עליי לעשות אם מפרט OpenAPI שלי נותן שגיאת פירוש?">
    בדקו שה-URL מצביע ישירות לקובץ JSON או YAML תקף של OpenAPI או Swagger ושהוא נגיש לציבור מהדפדפן שלכם. אם הקובץ מאחורי אימות או מוגש כ-HTML, Base44 לא יכולה לפרש אותו.

    אם אתם עדיין רואים שגיאות, עברו לאפשרות Paste JSON, העתיקו את ה-JSON הגולמי של המפרט שלכם ונסו שוב.

    לבדיקה מהירה, תוכלו גם לנסות מפרט ידוע ותקף כגון API דוגמה ציבורי כדי לאשר שהזרימה עובדת.
  </Accordion>
</AccordionGroup>

<Note>דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](/). </Note>