פעילויות

נקודות קצה לניהול פעילויות ומשימות מעקב.

רשימת פעילויות get

שליפת רשימה עם עימוד.

https://your-company.example.com/api/activities

כותרות חובה

פרמטר סוג תיאור
Accept חובה string `application/json`
Content-Type חובה string `application/json` (בבקשות עם גוף)
Authorization חובה string `Bearer {token}`

פרמטרי שאילתה

פרמטר סוג תיאור
page אופציונלי integer מספר עמוד. ברירת מחדל: 1.
per_page אופציונלי integer גודל עמוד (עד 100 ברוב המשאבים). ברירת מחדל: 15.
q אופציונלי string מחרוזת חיפוש חופשית.
order אופציונלי string מיון. דוגמה: `created_at` או `created_at|desc`.
select אופציונלי string בחירת שדות. דוגמה: `id;first_name;email`.
with אופציונלי string טעינת יחסים (eager load).

שליפת פעילות get

שליפת רשומה בודדת לפי מזהה.

https://your-company.example.com/api/activities/{activity}

כותרות חובה

פרמטר סוג תיאור
Accept חובה string `application/json`
Content-Type חובה string `application/json` (בבקשות עם גוף)
Authorization חובה string `Bearer {token}`

פרמטרים בנתיב

פרמטר סוג תיאור
activity חובה integer מזהה הרשומה.

יצירת פעילות post

יצירת רשומה חדשה. תשובה מוצלחת מחזירה סטטוס 201.

https://your-company.example.com/api/activities

כותרות חובה

פרמטר סוג תיאור
Accept חובה string `application/json`
Content-Type חובה string `application/json` (בבקשות עם גוף)
Authorization חובה string `Bearer {token}`

פרמטרים בגוף הבקשה

פרמטר סוג תיאור
title חובה string כותרת.
activity_type_id חובה integer סוג פעילות (אם אין ברירת מחדל במערכת).
due_date חובה datetime תאריך/שעת יעד (ISO או `Y-m-d`).
end_date אופציונלי datetime סיום.
user_id חובה integer בעלים.
description אופציונלי string תיאור.
note אופציונלי string הערה פנימית.
reminder_minutes_before אופציונלי integer תזכורת בדקות לפני (ברירת מחדל 30).
is_completed אופציונלי boolean האם הושלמה.
guests אופציונלי object `{users:[], contacts:[]}`.
contacts אופציונלי array מזהי אנשי קשר.
companies אופציונלי array מזהי חברות.
deals אופציונלי array מזהי עסקאות.

דוגמת גוף בקשה

{
    "title": "שיחת מעקב",
    "description": "לדון בהצעה",
    "due_date": "2026-08-01T15:00:00.000000Z",
    "end_date": "2026-08-01T16:00:00.000000Z",
    "reminder_minutes_before": 60,
    "activity_type_id": 1,
    "user_id": 1,
    "contacts": [
        1
    ],
    "is_completed": false
}

עדכון פעילות put

עדכון חלקי או מלא של רשומה קיימת.

https://your-company.example.com/api/activities/{activity}

כותרות חובה

פרמטר סוג תיאור
Accept חובה string `application/json`
Content-Type חובה string `application/json` (בבקשות עם גוף)
Authorization חובה string `Bearer {token}`

פרמטרים בנתיב

פרמטר סוג תיאור
activity חובה integer מזהה הרשומה.

פרמטרים בגוף הבקשה

פרמטר סוג תיאור
title אופציונלי string כותרת.
activity_type_id אופציונלי integer סוג פעילות (אם אין ברירת מחדל במערכת).
due_date אופציונלי datetime תאריך/שעת יעד (ISO או `Y-m-d`).
end_date אופציונלי datetime סיום.
user_id אופציונלי integer בעלים.
description אופציונלי string תיאור.
note אופציונלי string הערה פנימית.
reminder_minutes_before אופציונלי integer תזכורת בדקות לפני (ברירת מחדל 30).
is_completed אופציונלי boolean האם הושלמה.
guests אופציונלי object `{users:[], contacts:[]}`.
contacts אופציונלי array מזהי אנשי קשר.
companies אופציונלי array מזהי חברות.
deals אופציונלי array מזהי עסקאות.

מחיקת פעילות delete

מחיקה רכה. תשובה מוצלחת: 204 No Content.

https://your-company.example.com/api/activities/{activity}

כותרות חובה

פרמטר סוג תיאור
Accept חובה string `application/json`
Content-Type חובה string `application/json` (בבקשות עם גוף)
Authorization חובה string `Bearer {token}`

פרמטרים בנתיב

פרמטר סוג תיאור
activity חובה integer מזהה הרשומה.

צירוף שיוכים לפעילות put

https://your-company.example.com/api/associations/activities/{activity}

כותרות חובה

פרמטר סוג תיאור
Accept חובה string `application/json`
Content-Type חובה string `application/json` (בבקשות עם גוף)
Authorization חובה string `Bearer {token}`

פרמטרים בנתיב

פרמטר סוג תיאור
activity חובה integer מזהה הרשומה.

פרמטרים בגוף הבקשה

פרמטר סוג תיאור
contacts אופציונלי array מערך מזהים לשיוך. יש לספק לפחות משאב אחד.
companies אופציונלי array מערך מזהים לשיוך. יש לספק לפחות משאב אחד.
deals אופציונלי array מערך מזהים לשיוך. יש לספק לפחות משאב אחד.

דוגמת גוף בקשה

{
    "contacts": [
        1
    ],
    "companies": [
        2
    ],
    "deals": [
        3
    ]
}
יש לספק לפחות משאב אחד בגוף הבקשה.

ניתוק שיוכים מפעילות delete

https://your-company.example.com/api/associations/activities/{activity}

כותרות חובה

פרמטר סוג תיאור
Accept חובה string `application/json`
Content-Type חובה string `application/json` (בבקשות עם גוף)
Authorization חובה string `Bearer {token}`

פרמטרים בנתיב

פרמטר סוג תיאור
activity חובה integer מזהה הרשומה.

פרמטרים בגוף הבקשה

פרמטר סוג תיאור
contacts אופציונלי array מערך מזהים לשיוך. יש לספק לפחות משאב אחד.
companies אופציונלי array מערך מזהים לשיוך. יש לספק לפחות משאב אחד.
deals אופציונלי array מערך מזהים לשיוך. יש לספק לפחות משאב אחד.
יש לספק לפחות משאב אחד בגוף הבקשה.

סנכרון שיוכים לפעילות post

https://your-company.example.com/api/associations/activities/{activity}

כותרות חובה

פרמטר סוג תיאור
Accept חובה string `application/json`
Content-Type חובה string `application/json` (בבקשות עם גוף)
Authorization חובה string `Bearer {token}`

פרמטרים בנתיב

פרמטר סוג תיאור
activity חובה integer מזהה הרשומה.

פרמטרים בגוף הבקשה

פרמטר סוג תיאור
contacts אופציונלי array מערך מזהים לשיוך. יש לספק לפחות משאב אחד.
companies אופציונלי array מערך מזהים לשיוך. יש לספק לפחות משאב אחד.
deals אופציונלי array מערך מזהים לשיוך. יש לספק לפחות משאב אחד.
סנכרון מלא: מערך ריק למשאב מנתק את כל השיוכים של אותו סוג.

שינוי סטטוס פעילות post

נקודות הקצה /complete ו־/incomplete מיושנות. עדיף לעדכן עם is_completed.

https://your-company.example.com/api/activities/{activity}/complete

כותרות חובה

פרמטר סוג תיאור
Accept חובה string `application/json`
Content-Type חובה string `application/json` (בבקשות עם גוף)
Authorization חובה string `Bearer {token}`

פרמטרים בנתיב

פרמטר סוג תיאור
activity חובה integer מזהה פעילות.

דוגמת גוף בקשה

{
    "is_completed": true
}
מומלץ: PUT /api/activities/{id} עם {"is_completed": true} או false.

© 2026 BeCRM