אסימוני 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. לוח ניהול האסימונים מציג את האסימונים האישיים שלך המשוייכים לארגון הפעיל.

נדרש הרשאה: רק משתמשים עם תפקיד Admin או Maintainer יכולים לגשת ללוח זה. לפרטים על תפקידים, ראו סקירת הרשאות .

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

1. הזן שם כדי לציין את מטרת האסימון.

2. בחר תקופת תפוגה:

   • חודש אחד
   • שלושה חודשים
   • שנה אחת
   • ללא תוקף (תוקף בלתי מוגבל)

3. לחץ על “צור”.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

פתרון בעיות#

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

• סקירת הרשאות – הגדרות תפקיד מפורטות
• תוכניות תמחור – אילו תוכניות כוללות גישה ל‑API
• תיעוד REST API – תיעוד מפורט של נקודות הקצה