Chuyển tới nội dung chính

Chi Tiết Công Việc

Endpoint

URL: /api/v6.1/task Phương thức: GET

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

X-API-KEY: <your_api_key>

Tham số yêu cầu (Query Parameters)

Tham sốKiểu dữ liệuMô tả
fieldsstringDanh sách các trường cần lấy dữ liệu, phân tách bằng dấu phẩy.
task_codestringMã công việc cần lấy chi tiết.

Ví dụ Request

curl --location 'https://xxx.getflycrm.com/api/v6.1/task?fields=id%2Ctask_code%2Ctask_name%2Ctask_start_date%2Ctask_end_date%2Ctask_status%2Ctask_receiver_display_name%2Cproject_name&task_code=CVI%2F2025-02%2F0075' \
--header 'X-API-KEY: <your_api_key>'

Phản hồi (Response)

Cấu trúc Response

{
"task_code": "CVI/2025-02/0075",
"task_name": "Tụ họp",
"task_start_date": "2025-02-20 09:32:35",
"task_end_date": "2025-02-20 10:32:35",
"notifications_count": 0,
"task_status": 11,
"task_progress": 0,
"user_important": 0,
"task_receiver": 2,
"task_receiver_display_name": "Người nhận công việc",
"task_receiver_email": "[email protected]",
"task_receiver_phone": "",
"task_receiver_avatar": "photo_2024-12-13_21-32-10.jpg",
"task_color": "",
"project_id": 1,
"project_name": "Công việc",
"task_remain_day": 1,
"task_emoji": "lbl_emoji_no_feelings",
"task_creator": 2,
"left": 172,
"right": 173,
"task_object": null,
"valid": 1,
"project_status": 2,
"project_valid": 1,
"my_level": 0,
"custom_fields": [],
"task_status_title": "Còn 1 ngày",
"task_accounts": []
}

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

TrườngKiểu dữ liệuMô tả
task_codestringMã công việc.
task_namestringTên công việc.
task_start_datestringNgày và giờ bắt đầu công việc.
task_end_datestringNgày và giờ kết thúc công việc.
notifications_countintegerSố lượng thông báo liên quan đến công việc.
task_statusintegerTrạng thái của công việc.
task_progressintegerTiến độ của công việc (0-100%).
user_importantintegerĐánh dấu mức độ quan trọng của công việc.
task_receiverintegerID của người nhận công việc.
task_receiver_display_namestringTên hiển thị của người nhận công việc.
task_receiver_emailstringEmail của người nhận công việc.
task_receiver_phonestringSố điện thoại của người nhận công việc.
task_receiver_avatarstringẢnh đại diện của người nhận công việc.
task_colorstringMàu sắc của công việc.
project_idintegerID dự án liên quan.
project_namestringTên dự án liên quan.
task_remain_dayintegerSố ngày còn lại để hoàn thành công việc.
task_emojistringBiểu tượng trạng thái công việc.
task_creatorintegerID của người tạo công việc.
leftintegerGiá trị left trong cây nhiệm vụ.
rightintegerGiá trị right trong cây nhiệm vụ.
task_objectobjectĐối tượng liên quan đến công việc (nếu có).
validintegerXác định công việc có hợp lệ không.
project_statusintegerTrạng thái của dự án chứa công việc.
project_validintegerXác định dự án có hợp lệ không.
my_levelintegerCấp độ của người dùng đối với công việc.
custom_fieldsarrayDanh sách các trường tùy chỉnh.
task_status_titlestringTiêu đề trạng thái của công việc.
task_accountsarrayDanh sách tài khoản liên quan đến công việc.

Ghi chú

  • API này trả về thông tin chi tiết của một công việc dựa trên task_code.
  • Nếu công việc không tồn tại, API sẽ trả về lỗi.