Thêm Mới Công Việc

Endpoint

URL: /api/v6.1/task

Phương thức: POST

Tiêu đề yêu cầu (Request Headers)

Content-Type: application/json
X-API-KEY: <your_api_key>

Dữ liệu yêu cầu (Request Body)

Trường	Kiểu dữ liệu	Mô tả
task_name	string	Tên công việc.
task_start_date	string	Ngày và giờ bắt đầu công việc (định dạng YYYY-MM-DD HH:MM:SS).
task_end_date	string	Ngày và giờ kết thúc công việc (định dạng YYYY-MM-DD HH:MM:SS).
project_name	string	Tên dự án liên quan.
task_parent_code	string	Mã công việc cha (nếu có).
task_type_name	string	Loại công việc.
task_code	string	Mã công việc duy nhất.
task_weight	integer	Mức độ ưu tiên của công việc.
task_description	string	Mô tả nội dung công việc (hỗ trợ HTML).
task_receiver_username	string	Tên người nhận công việc.
related_users	array	Danh sách người dùng liên quan.
task_color	string	Màu sắc của công việc.
custom_fields	object	Trường tùy chỉnh chứa các thông tin bổ sung.
custom_fields.ngay_bay	string	Ngày bay liên quan (nếu có).
custom_fields.ma_chuyen_bay	string	Mã chuyến bay (nếu có).
custom_fields.ky_thuat_vien	string	Kỹ thuật viên phụ trách (nếu có).
task_accounts	array	Danh sách tài khoản liên quan đến công việc.
task_accounts.account_code	string	Mã khách hàng/tài khoản liên quan.
task_accounts.account_phone	string	Số điện thoại tài khoản.
task_accounts.contact_name	string	Tên người liên hệ của tài khoản.
task_accounts.account_name	string	Tên tài khoản/khách hàng.

{
  "task_name": "[L4] Công việc form API",
  "task_start_date": "2025-03-14 19:00:00",
  "task_end_date": "2025-03-14 21:00:00",
  "project_name": "Dự án API",
  "task_parent_code": "Task.0001",
  "task_type_name": "Làm hồng",
  "task_code": "Task.0003",
  "task_weight": 48,
  "task_description": "<p>Nội dung công việc</p>",
  "task_receiver_username": "nguoilinh",
  "related_users": [
    "nguoilinh",
    "sangkhanh",
    "trandinhcuong"
  ],
  "task_color": "#06aed4",
  "custom_fields": {
    "ngay_bay": "2025-03-18",
    "ma_chuyen_bay": "SGN.912812",
    "ky_thuat_vien": "Kỹ thuật viên A"
  },
  "task_accounts": [
    {
      "account_code": "KH-VUIN",
      "account_phone": "0988977888",
      "contact_name": "Khách hàng B",
      "account_name": "Công ty ABC"
    }
  ]
}

Ví dụ Request

curl --location 'https://xxxxx.getflycrm.com/api/v6.1/task' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <your_api_key>' \
--header 'Cookie: v6_getflycrm_session=<your_session_token>' \
--data '{
    "task_name": "[L4] Công việc form API",
    "task_start_date": "2025-03-14 19:00:00",
    "task_end_date": "2025-03-14 21:00:00",
    "project_name": "Dự án API",
    "task_parent_code": "Task.0001",
    "task_type_name": "Làm hồng",
    "task_code": "Task.0003",
    "task_weight": 48,
    "task_description": "<p>Nội dung công việc</p>",
    "task_receiver_username": "nguoilinh",
    "related_users": [
        "nguoilinh",
        "sangkhanh",
        "trandinhcuong"
    ],
    "task_color": "#06aed4",
    "custom_fields": {
        "ngay_bay": "2025-03-18",
        "ma_chuyen_bay": "SGN.912812",
        "ky_thuat_vien": "Kỹ thuật viên A"
    },
    "task_accounts": [
        {
            "account_code": "KH-VUIN",
            "account_phone": "0988977888",
            "contact_name": "Khách hàng B",
            "account_name": "Công ty ABC"
        }
    ]
}'

Phản hồi (Response)

{
  "message": "Thêm mới thành công",
  "data": {
    "task_id": 98,
    "task_code": "Task.0003"
  }
}

Mô tả Các Trường Trong Response

Trường	Kiểu dữ liệu	Mô tả
message	string	Thông báo trạng thái của API.
data.task_id	integer	ID của công việc mới được tạo.
data.task_code	string	Mã công việc mới được tạo.

Ghi chú

• API này được sử dụng để thêm mới một công việc.
• Nếu thành công, API trả về thông báo "Thêm mới thành công" cùng task_id và task_code của công việc mới tạo.