# שימוש בגישה דרך API

> צרו אסימוני גישה אישיים לסקריפטים וללקוחות MCP, ושלחו אירועים מה-Livespace שלכם למערכות שלכם באמצעות webhooks.

בהגדרות › **גישה דרך API**, אפשר ליצור אסימוני גישה אישיים כדי שסקריפט או לקוח MCP יוכלו להשתמש ב-Dvina בשמכם. מנהלי מערכת יכולים גם להוסיף שם webhooks כדי לשלוח אירועים מה-Livespace למערכות שלהם.

גישה דרך API כלולה בתוכנית Enterprise. כל חבר יכול ליצור אסימונים משלו; רק בעלים ומנהלי מערכת רואים את **Webhooks**.

## יצירת אסימון

1. פתחו את ההגדרות ובחרו **גישה דרך API**.
2. תחת **אסימוני גישה אישיים**, בחרו **יצירת אסימון**.
3. הזינו **שם** כדי שתוכלו לזהות בהמשך מה משתמש באסימון.
4. בחרו את הרשאת ה**גישה**: **קריאה בלבד** או **קריאה וכתיבה**.
5. בחרו מתי **התוקף פג**: **בעוד 30 ימים**, **בעוד 90 ימים**, **בעוד 365 ימים** או **ללא תפוגה**.
6. בחרו **יצירת אסימון**.
7. תחת **העתקת האסימון שלכם**, העתיקו את האסימון ושמרו אותו במקום בטוח. זו הפעם היחידה שבה הוא מוצג.

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

כדי להשתמש באסימון עם לקוח MCP, ראו [התחברות עם מפתח API במקום OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## בדיקה, החלפה או ביטול של אסימון

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

- **כדי להחליף אסימון**, בחרו **החלפה…** ואז **החלפה** לאישור. אסימון חדש יחליף אותו, והאסימון הישן יפסיק לפעול מיד. העתיקו את האסימון החדש תחת **העתקת האסימון שלכם**.
- **כדי לבטל אסימון**, בחרו **ביטול…** ואז **ביטול** לאישור. כל מה שמשתמש בו יפסיק לפעול מיד.

יצירה, החלפה וביטול של אסימון מתועדים ב[יומן הביקורת](/docs/teams/audit-log).

## הוספת webhook

webhook שולח אירועים מה-Livespace לכתובת שתבחרו. אלה אותן רשומות שמופיעות ב[יומן הביקורת](/docs/teams/audit-log).

1. בהגדרות › **גישה דרך API**, תחת **Webhooks**, בחרו **הוספת Webhook**.
2. הזינו **שם** ו**כתובת URL**. השתמשו בכתובת HTTPS נגישה לציבור.
3. תחת **אירועים**, השאירו את השדה ריק כדי לקבל את כל האירועים, או ציינו פעולות ותחומים, כגון `member.added` או `sharing.*`.
4. בחרו **הוספה**.
5. תחת **העתקת הסוד לחתימה**, העתיקו את הסוד. זו הפעם היחידה שבה הוא מוצג.

אם Dvina מציגה את ההודעה **לא ניתן להגיע לכתובת הזו מ-Dvina**, השתמשו בכתובת HTTPS נגישה לציבור.

### בדיקת החתימה של כל בקשה

Dvina שולחת אירועים בקבוצות, בפורמט JSON, וחותמת על כל בקשה. השתמשו בסוד לחתימה כדי לבדוק שהבקשה הגיעה מ-Dvina:

- לכל בקשה יש כותרת `X-Dvina-Signature` במבנה `t=<timestamp>,v1=<signature>`.
- החתימה היא ערך HMAC-SHA256 בייצוג הקסדצימלי, המחושב מחותמת הזמן, נקודה וגוף הבקשה, באמצעות הסוד שלכם לחתימה.
- חשבו את החתימה בעצמכם והשוו. דחו בקשה שהחתימה שלה אינה תואמת או שחותמת הזמן שלה ישנה מדי.

## בדיקה או שינוי של webhook

ה-webhooks שלכם מופיעים תחת **Webhooks** עם הסטטוס שלהם: **פעיל**, **מושהה** או **נכשל**. בחרו אחד מהם כדי לראות את הפרטים שלו.

- **כדי לשנות אותו**, ערכו את ה**שם**, ה**כתובת (URL)** או ה**אירועים**, ואז בחרו **שמירה**.
- **כדי להשהות אותו**, כבו את **שליחת אירועים**. הפעילו אותה שוב כדי לחדש את השליחה.
- **כדי לבדוק איך הוא פועל**, בדקו את ה**סטטוס** שלו וכמה אירועים **נשלחו**. ב-webhook שנכשל מופיעה ה**שגיאה האחרונה** שלו. Dvina ממשיכה לנסות ומתעדת את הכשל ביומן הביקורת.
- **כדי לשנות את הסוד שלו**, בחרו **סוד חתימה חדש…**, ואז אשרו. הבקשות נחתמות בסוד החדש מיד, לכן עדכנו מיד את הצד המקבל.
- **כדי להסיר אותו**, בחרו **מחיקה…**, ואז **מחיקה** לאישור. לא יישלח אליו דבר נוסף.

## מידע קשור

- [שימוש ב-Dvina מאפליקציות אחרות באמצעות MCP](/docs/dvina-mcp/overview)
- [שימוש ביומן הביקורת](/docs/teams/audit-log)
- [סקירה כללית של צוותים](/docs/teams/overview)