API יוצא

מתוך Mind Connect
גרסה מ־13:09, 30 בינואר 2025 מאת Maksym (שיחה | תרומות)
(הבדל) → הגרסה הקודמת | הגרסה האחרונה (הבדל) | הגרסה הבאה ← (הבדל)
קפיצה לניווט קפיצה לחיפוש

סקירה כללית

עמוד API יוצא מאפשר קישור אוטומטי ושליחת נתונים מהמערכת CRM לכל מערכת שתומכת בקבל API.

גישה למערכת

עמוד "API יוצא" נמצא כברירת מחדל בתפריט הראשי תחת: "פרויקטים" ← "ניהול" ← "API יוצא".


בעמוד API יוצא, המשתמשים יכולים:

  • לצפות בחוקי API קיימים
  • ליצור חוקי API חדשים על ידי לחיצה על כפתור "חדש"

תהליך יצירת חוק API חדש

שלב ראשון: פתיחת טופס חדש

  1. לחץ על כפתור "חדש" בעמוד API יוצא
  2. ייפתח מסך יצירת API חדש
יצירת חוק API יוצא.png

הגדרות בסיסיות

במסך היצירה יש להזין את הפרטים הבאים:

  • בחירת פרויקט: יש לבחור את הפרויקט אליו ישויך חוק ה-API
  • שם: הגדרת שם לחוק ה-API
  • תיאור: שדה אופציונלי המאפשר הוספת הסבר מפורט על מטרת החוק
  • סוג קריאת API: יש לבחור את סוג הקריאה המתאים:
    • GET
    • POST
    • PUT
    • PATCH
  • קישור API: יש להזין את כתובת ה-URL של ה-API (ניתן למצוא בדוקומנטציה של ה-API החיצוני)

הגדרת שדות

שדות גוף וכותרת

השדות מורכבים משני חלקים:

  1. מפתח: שם הפרמטר
  2. ערך: הערך שיישלח עבור אותו פרמטר

סוגי ערכים אפשריים:

  • ערך סטטי: ערך קבוע (לדוגמה: מפתח AUTHORIZATION)
  • ערך דינמי: ערך המתקבל מטופס הלקוחות (לדוגמה: שם, מספר טלפון וכו')

שמירת החוק

לאחר הזנת כל הפרטים והשדות הנדרשים:

  1. לחץ על כפתור "החל"
  2. החוק יישמר במערכת ויהיה מוכן לשימוש

הפעלת API מדף הלקוח

גישה לדף הלקוח

ניתן להגיע לדף הלקוח באחת משתי דרכים:

  • חיפוש לקוח במערכת
  • גישה דרך מאגר - "הצג לקוח"
הפעלת חוק API יוצא.png

יצירת קשר והפעלת API

  1. בדף הלקוח, אתר את כפתור "צור קשר"
  2. לחץ על הכפתור להצגת תפריט נפתח (Drop Down Menu)
  3. בחר באפשרות "שלח API" מתוך התפריט
  4. בחר את חוק ה-API הרצוי מתוך הרשימה
  5. המערכת תשלח את קריאת ה-API עם הפרמטרים המוגדרים בחוק

צפייה בהיסטוריית API

ניתן לצפות בהיסטוריית הקריאות והתשובות של ה-API בשני מקומות:

  1. בעמוד API יוצא: היסטוריית קריאות ה-API עבור חוק ספציפי
  2. היסטוריית API: צפייה בכל קריאות ה-API שבוצעו במערכת

מידע הזמין בהיסטוריה

  • זמן ביצוע הקריאה
  • סטטוס הקריאה
  • תשובת ה-API
  • פרטי הבקשה ששודרה