הצטרפות

שעות עבודה ב-API

ניהול שעות עבודה ב-API

ה-API מאפשר לרשום שעות עבודה (רישום בודד לכל קריאה). כל השיוכים אופציונליים: משתמש (לפי user_email או user_id), פרויקט (project_id / external_project_id), אבן דרך (milestone_id / external_milestone_id — בתוך הפרויקט), ולקוח.

ה-endpoints

  • POST /api/workingHours/addWorkingHour — יצירת רישום שעות.
  • POST /api/workingHours/updateWorkingHour — עדכון לפי id (GUID) או external_working_hour_id.
  • POST /api/workingHours/addOrUpdateWorkingHour — יצירה או עדכון (Upsert). מומלץ.
  • POST /api/workingHours/searchWorkingHours — חיפוש מעומד (paginated) לפי פרויקט, לקוח, משתמש, וטווח תאריכי התחלה.

שדות

  • start_date / end_date — בפורמט dd/MM/yyyy HH:mm.
  • hours — מספר שעות (אפשר לציין שעות ו/או טווח זמן).
  • price_per_hour, currency_id, description, role_id.
  • external_working_hour_id — מזהה ממערכת חיצונית, משמש ל-Upsert.

דוגמה — יצירת רישום שעות:

POST /api/workingHours/addWorkingHour

{
  "api_key": "YOUR_API_KEY",
  "test": 0,
  "contact_email": "dev@example.com",
  "contact_phone": "050-1234567",
  "user_email": "employee@example.com",
  "project_id": 95,
  "milestone_id": 1,
  "start_date": "01/06/2026 09:00",
  "end_date": "01/06/2026 12:30",
  "hours": 3.5,
  "price_per_hour": 200,
  "description": "פיתוח מסך הזמנות"
}

בתגובה חוזרים id (GUID) ו-working_hour_id (מזהה פנימי).

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

x

הצטרפות