Cập nhật trường định nghĩa dữ liệu cơ hội

Endpoint

PUT /api/v6.1/opportunity/define_field

Cách gọi API

curl --location --request PUT 'https://demo.getflycrm.com/api/v6.1/opportunity/define_field' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: YOUR_API_KEY' \
--data-raw '{
    "define_field_id": 14,
    "field_description": "Ngân sách dự kiến của khách hàng",
    "field_requirenotnull": 1,
    "check_duplicate": 0
}'

Tham số trong body

Trường	Kiểu	Bắt buộc	Mô tả
define_field_id	integer	Có	ID trường định nghĩa dữ liệu cần cập nhật
field_name	string	Không	Tên kỹ thuật của trường
field_description	string	Không	Nhãn hiển thị / mô tả của trường
field_requirenotnull	integer	Không	Bắt buộc nhập: 1 = có, 0 = không
field_ismultiple	integer	Không	Cho phép chọn nhiều (chỉ với select, checkbox): 1 = có
check_duplicate	integer	Không	Kiểm tra trùng lặp: 1 = có, 0 = không
field_hidden	integer	Không	Ẩn trường: 1 = ẩn, 0 = hiện
define_field_lists	array	Không	Danh sách lựa chọn (dùng cho select, checkbox)
define_field_lists.*.id	integer	Không	ID lựa chọn hiện có (bỏ qua để thêm lựa chọn mới)
define_field_lists.*.list_value	string	Không	Giá trị của lựa chọn
deleted_define_field_list_ids	array	Không	Danh sách ID lựa chọn cần xóa

Phản hồi mẫu

{
  "message": "Cập nhật thành công",
  "data": {
    "define_field_id": 14
  }
}

Ghi chú

• Chỉ các trường được truyền vào mới được cập nhật, các trường không truyền giữ nguyên giá trị cũ.
• Để xóa một lựa chọn trong select/checkbox, thêm ID lựa chọn đó vào deleted_define_field_list_ids.
• Để thêm lựa chọn mới vào select/checkbox, thêm object không có id vào define_field_lists.