תיעוד API

חיבור ועבודה עם ממשק ה-API של Shifton

הממשק Shifton API מעניק לכם גישה לכל התכונות המרכזיות של הפלטפורמה — מניהול לוחות זמנים ועד אינטגרציות עם מערכות , שכר חיצוניות, ומערכות ניתוח נתונים.
על ידי שימוש ב-API, תוכלו לאוטומט תהליכים ולחבר את Shifton לשירותים פנימיים של החברה שלכם.

תיעוד API

אנו תומכים בשתי גרסאות של התיעוד שלנו:

• 📄 תיעוד ישן — הגרסה הקודמת של מדריך ה-API (עדיין נתמכת עבור אינטגרציות קיימות):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 תיעוד חדש — גרסת ה-API הנוכחית עם מבנה מעודכן ושיטות חדשות ביותר:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

להתחיל בעבודה

השגת מפתח API

במהלך הגדרות החברה שלכם בפלטפורמת Shifton, צרו מפתח API.
האישור נעשה דרך הכותרת:

בצעו את הבקשה הראשונה שלכם

לדוגמה, כדי להחזיר רשימת עובדים:

תגובה לדוגמה:

שילוב ה-API במהלכים שלכם

• יצירה ושינוי אוטומטי של משמרות

• ניהול בקשות חופשה ומחלה

• ייצוא נתונים למערכות שכר

• בנו לוחות מחוונים ודוחות מותאמים אישית

יכולות API בסיסיות

• עובדים – הוספה, עריכה וניהול תפקידים

• לוחות זמנים – יצירה, התאמת משמרות, תכנון עבודה

• חופשות והיעדרויות – ניהול בקשות חופשה ומחלה

• דיווחים – ייצוא נתוני זמן, שכר ונוכחות

קודי שגיאה

ה-API של Shifton משתמש בקודי מצב סטנדרטיים של HTTP:

• 200 — בקשה מוצלחת

• 201 — אובייקט נוצר בהצלחה

• 400 — פרמטרים לא תקינים

• 401 — שגיאה בהרשאה (מפתח API לא תקין)

• 403 — גישה נדחתה

• 404 — משאב לא נמצא

• 500 — שגיאת שרת

טיפים לשימוש

• תמיד השתמשו ב-גרסת API החדשה עבור אינטגרציות חדשות

• השתמש בPostman או curl לבדיקות

• כבד את מגבלות הקצבים כדי להימנע מחסימות

• עדכן אינטגרציות שעדיין נסמכות על התיעוד הישן