# אסימוני API | Procurize.AI

**צור, נהל והשתמש באסימוני API לגישה תוכנתית בטוחה למרחב העבודה של Procurize.AI שלך.**

> **חל על:** Procurize.AI Dashboard → Settings → Tokens  
> **זמין ב:** תוכניות Business & Enterprise  
> **תפקיד נדרש:** Admin או Maintainer

## סקירה כללית

אסימוני API מאפשרים גישה תוכנתית מאובטחת לפלטפורמת Procurize.AI. ניתן להשתמש באסימונים כדי לשלב את Procurize.AI עם המערכות הפנימיות, לאוטומט תהליכים, או לבנות יישומים מותאמים על גבי הפלטפורמה.

**מאפיינים מרכזיים:**

- אסימונים יורשים **את כל ההרשאות** של המשתמש שיצר אותם
- אסימונים מיועדים **לארגון** – אין צורך לציין `org` בקריאות API
- ניתן ליצור אסימונים בלתי מוגבלים
- לאסימונים יכולים להיות **תאריכי תפוגה** או מוגדרים ללא תוקף
- אסימונים יכולים להיות **מושבתים** ולאחר מכן **מושבחים** לפי הצורך

> 🔒 **הערת אבטחה:** Procurize.AI **לא** שומר את ערך האסימון – רק את הגיבוב שלו. עליך להעתיק ולשמור את האסימון מיד לאחר יצירתו. הוא לא יוצג שוב.

## גישה ללוח ניהול האסימונים

1. נווט אל **Dashboard** → **Settings** → לשונית **Tokens**.
2. לוח ניהול האסימונים מציג את האסימונים האישיים שלך המשוייכים לארגון הפעיל.

![לוח אסימוני API](/images/docs/api-tokens-panel.png)

> **נדרש הרשאה:** רק משתמשים עם תפקיד **Admin** או **Maintainer** יכולים לגשת ללוח זה. לפרטים על תפקידים, ראו [סקירת הרשאות](/what-user-permissions-does-procurize-have/) .

## יצירת אסימון חדש

1. הזן **שם** כדי לציין את מטרת האסימון.
2. בחר **תקופת תפוגה**:
   - חודש אחד
   - שלושה חודשים
   - שנה אחת
   - **ללא תוקף** (תוקף בלתי מוגבל)

3. לחץ על **"צור"**.

### חשוב – העתק את האסימון מיד

לאחר היצירה ערך האסימון **מוצג פעם אחת בלבד** – העתק אותו ושמור במקום מאובטח (למשל במנהל סיסמאות או במשתנה סביבתי).

![אסימון API חדש](/images/docs/new-api-token.png)

> ⚠️ **לא תוכל לראות שוב את ערך האסימון.** Procurize.AI שומר רק גיבוב מאובטח לצורך אימות. אם האסימון אבד, עליך לבטלו וליצור חדש.

## ניהול אסימונים קיימים

לוח האסימונים מציג רשימה של כל האסימונים שנוצרו עם הפרטים הבאים:

- שם
- סיווג (Suffix)
- תאריך יצירה
- תאריך תפוגה (או "-")
- סטטוס: **פעיל** או **לא פעיל**

### השבתה / השבה של אסימון

- **השבתה** – משבית את האסימון באופן זמני. ניתן להשיבו להפעיל במועד מאוחר יותר.
- **השבה** – מחזיר אסימון שהושבת למצב פעיל.

> 💡 השבתה שימושית כאשר רוצים להשהות אינטגרציה זמנית ללא מחיקת האסימון.

### ביטול אסימון

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

## שימוש באסימון API

### כתובת בסיס ואימות

| פרמטר | ערך |
|-----------|-------|
| **כתובת הבסיס** | `https://api.procurize.com` |
| **שיטת אימות** | מפתח API דרך כותרת |
| **כותרת** | `X-API-Key: <YOUR_API_TOKEN>` |

### דוגמת בקשה (cURL)

```bash
curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"
```

> 🧠 **אין צורך במזהה ארגון** – האסימון קשור לארגון שלך, ולכן ה‑API פותר את ההקשר באופן אוטומטי.

## כללי אבטחה ושימוש חשובים

| כלל | הסבר |
|------|-------------|
| **הרשאות האסימון** | האסימון בעל אותו סט הרשאות בדיוק כמו המשתמש שיצר אותו. שינוי בתפקיד המשתמש מעדכן אוטומטית את הרשאות האסימון. |
| **קיבוע לארגון** | אסימונים קשורים לארגון של היוצר. לא ניתן להשתמש באסימון במספר ארגונים. |
| **חשיפות אסימון** | ערך האסימון מוצג **פעם אחת בלבד**. שמור אותו מיד. Procurize.AI שומר רק גיבוב. |
| **אסימונים שפגו** | אסימונים שפגו מושבתים אוטומטית ולא ניתן להשתמש בהם. צור אסימון חדש אם יש צורך. |

## פתרון בעיות

| בעיה | פתרון |
|-------|----------|
| **שגיאת "מפתח API לא תקין"** | ודא שהאסימון הועתק במדויק (בלי רווחים נוספים). בדוק שהאסימון עדיין פעיל ולא פג תוקפו. |
| **האסימון לא פועל לאחר שינוי תפקיד** | הרשאות האסימון מתעדכנות לפי התפקיד הנוכחי של המשתמש. אם למשתמש נפסקות ההרשאות, האסימון מאבד אותן גם הוא. |
| **איבוד אסימון** | בטל את האסימון האבוד וצור אסימון חדש. |
| **הגבלת קצב** | מגבלות קצב API חלות בהתאם לתוכנית שלך. בדוק את כותרות `X-RateLimit-*` בתשובה. |

## נושאים קשורים

- [סקירת הרשאות](/what-user-permissions-does-procurize-have/) – הגדרות תפקיד מפורטות  
- [תוכניות תמחור](https://www.procurize.ai/pricing/) – אילו תוכניות כוללות גישה ל‑API  
- [תיעוד REST API](/rest-api-reference/) – תיעוד מפורט של נקודות הקצה

{{<article-feedback>}}