כיצד ליצור אסימון API ולהשתמש בו

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

למה ניתן להשתמש באסימון API?

• שליחת נתונים מ-TicketingHub לתוכנת דיווח או למחסן נתונים.
• מתן אפשרות לפלטפורמת שותף מותאמת אישית לקרוא מוצרים ומחירים.
• בניית תהליך הזמנה בצד השרת שבודק זמינות בזמן אמת.

אסימון API אינו יוצר חיבור מובנה ל-Google Sheets. עיינו במאמר כיצד לייצא נתונים מ-TicketingHub ולחבר כלים אחרים כדי לבחור בין ייצוא לקובצי CSV,‏ Zapier, וובהוקים וגישה באמצעות API.

הפעלת גישה ל-API

1. עברו אל הגדרות → תכונות.
2. הפעילו את Api access.

זוהי הגדרה בשירות עצמי. לאחר שתפעילו אותה, האפשרות אסימוני API תופיע בהגדרות.

יצירת אסימון

1. עברו אל הגדרות → אסימוני API.
2. בחרו באפשרות Generate API token.
3. הזינו שם שמזהה את המערכת המשתמשת באסימון.
4. בחרו באפשרות Supplier API (V2) לניהול ספקים, באפשרות Widget API לזמינות ולהזמנות, או באפשרות OCTO API לחיבור מערכות המשתמשות ב-תקן OCTO.
5. אם בחרתם ב-Supplier API (V2) או ב-OCTO API, תוכלו לבחור באפשרות Read-only כאשר האינטגרציה זקוקה רק לצפייה בנתונים. אפשרות זו אינה חלה על אסימוני Widget API.
6. הוסיפו תאריך תפוגה לפי הצורך ולאחר מכן צרו את האסימון.
7. העתיקו את האסימון מיד ושמרו אותו באופן מאובטח. האסימון המלא יוצג פעם אחת בלבד.

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

שלחו את האסימון בכותרת Authorization של כל בקשת API:

Authorization: Bearer YOUR_TOKEN

השתמשו באסימוני API רק במערכות מאובטחות בצד השרת. אין להציב אסימון בקוד של אתר, בהודעות דוא״ל, בהודעות צ׳אט או במסמכים משותפים.

ביטול אסימון

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

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