אסימוני API | Procurize.AI#
צור, נהל והשתמש באסימוני API לגישה תוכניתית מאובטחת למרחב העבודה שלך ב‑Procurize.AI.
חל על: לוח הבקרה של Procurize.AI → הגדרות → אסימונים
זמין ב: תוכניות Business ו‑Enterprise
תפקיד נדרש: מנהל אבטחה, עורך, מנהל או מתחזק
סקירה#
אסימוני API מאפשרים גישה תוכניתית מאובטחת לפלטפורמת Procurize.AI. ניתן להשתמש באסימונים כדי לשלב את Procurize.AI עם מערכות פנימיות, לאוטומט תהליכים, או לבנות יישומים מותאמים על גבי הפלטפורמה.
מאפיינים מרכזיים:
- האסימונים יורשים את כל ההרשאות של המשתמש שיצר אותם
- האסימונים הם במסגרת הארגון – אין צורך לציין
orgבקריאות API - ניתן ליצור אסימונים ללא מגבלה
- לאסימונים יכולים להיות תאריכי תפוגה או להיות ללא תפוגה
- ניתן להשבית אסימונים ולשחזר אותם מאוחר יותר לפי הצורך
🔒 הערת אבטחה: Procurize.AI אינה מאחסנת את ערך האסימון – רק את ההאש שלו. עליך להעתיק ולשמור את האסימון מיד לאחר יצירתו. הוא לא יוצג שוב.
גישה ללוח ניהול האסימונים#
- נווט אל דף לוח הבקרה → אסימוני API.
- לוח ניהול האסימונים מציג את האסימונים האישיים שלך המשוייכים לארגון הנוכחי.
הרשאה נדרשת: רק משתמשים עם תפקידים מנהל אבטחה, עורך, מנהל או מתחזק יכולים לגשת ללוח זה. להגדרות תפקיד מפורטות, ראה סקירת הרשאות .
יצירת אסימון חדש#
הזן שם כדי לזהות את מטרת האסימון.
בחר תקופת תפוגה:
- 1 חודש
- 3 חודשים
- 1 שנה
- ללא תפוגה (תוקף בלתי מוגבל)
לחץ על “צור”.
חשוב – העתק את האסימון מיד#
לאחר יצירה, ערך האסימון מוצג פעם אחת – העתק אותו ושמור אותו בצורה מאובטחת (למשל במנהל סיסמאות או במשתנה סביבתי).
⚠️ לא תוכל לראות את ערך האסימון שוב. Procurize.AI מאחסנת רק האש מאובטח לצורך אימות. אם תאבד את האסימון, עליך לבטלו וליצור חדש.
ניהול אסימונים קיימים#
לוח האסימונים מציג רשימה של כל האסימונים שנוצרו עם:
- שם
- סיומת
- תאריך יצירה
- תאריך תפוגה (או “-”)
- סטטוס: פעיל או לא פעיל
השבתה / הפעלה מחדש של אסימון#
- השבת – משבית את האסימון באופן זמני. ניתן להפעיל אותו מחדש מאוחר יותר לפי הצורך.
- הפעל מחדש – מחזיר אסימון שהושבת למצב פעיל.
💡 השבתה שימושית להשהיית אינטגרציות באופן זמני מבלי למחוק את האסימון.
ביטול אסימון#
- בטל – מוחק את האסימון לצמיתות. פעולה זו אינה ניתנת לביטול.
- אם אתה מאבד אסימון, בטל אותו מיד וצור חדש.
שימוש באסימון API#
כתובת בסיסית ואימות#
| פרמטר | ערך |
|---|---|
| כתובת בסיסית | https://api.procurize.com |
| שיטת אימות | מפתח API דרך כותרת |
| כותרת | X-API-Key: <YOUR_API_TOKEN> |
דוגמת בקשה (cURL)#
curl -X GET "https://api.procurize.com/v1/documents" \
-H "X-API-Key: YOUR_API_TOKEN"
🧠 לא נדרש מזהה ארגון – האסימון קשור לארגון שלך, ולכן ה‑API פותר את ההקשר אוטומטית.
כללים חשובים לאבטחה ושימוש#
| כלל | הסבר |
|---|---|
| הרשאות אסימון | האסימון בעל בדיוק את אותן ההרשאות של המשתמש שיצר אותו. אם תפקיד המשתמש משתנה, הרשאות האסימון מתעדכנות בהתאם. |
| קישור לארגון | אסימונים קשורים לארגון של היוצר. לא ניתן להשתמש באסימון במספר ארגונים. |
| נראות אסימון | ערך האסימון מוצג פעם אחת בלבד. שמור אותו מיד. Procurize.AI מאחסנת רק האש. |
| אסימונים שפג תוקפם | אסימונים שפג תוקפם מושבתים אוטומטית ולא ניתנים לשימוש. צור אסימון חדש במידת הצורך. |
פתרון בעיות#
| בעיה | פתרון |
|---|---|
| שגיאת “מפתח API לא חוקי” | בדוק שהאסימון הועתק כראוי (ללא רווחים מיותרים). וודא שהאסימון עדיין פעיל ולא פג תוקף. |
| האסימון אינו עובד לאחר שינוי תפקיד | הרשאות האסימון מתעדכנות כדי להתאים לתפקיד הנוכחי של המשתמש. אם למשתמש נלקחו הרשאות, האסימון גם מאבד אותן. |
| איבוד אסימון | בטל את האסימון האבוד וצור חדש. |
| הגבלת קצב | מגבלות קצב API חלות בהתאם לתוכנית שלך. בדוק את הכותרות X-RateLimit-* בתגובה. |
נושאים קשורים#
- סקירת הרשאות – הגדרות תפקיד מפורטות
- תוכניות תמחור – אילו תוכניות כוללות גישה ל‑API
- תיעוד REST API – תיעוד מפורט של נקודות הקצה