下拉列表數據

獲取下拉列表數據

• API 地址：metadata/picklist
• HTTP 方法：GET
• 授權方式：通用授權

請求參數

參數	類型	是否必須	參數說明
entity	string	是	實體內部名稱
fields	string	否	字段內部名稱，不填寫則返回實體的所有下拉列表字段項

返回數據示例

{
  "error_code": 0,
  "error_msg": "調用成功",
  "data": [{
    "field": "typeCode",
    "values": [
      { "value": 0, "label": "正式客戶" },
      { "value": 1, "label": "潛在客戶" },
      { "value": 2, "label": "合作伙伴" }]
  }]
}

返回數據說明

字段	類型	字段說明
field	string	字段內部名稱
values	array	picklist 列表
values/value	int	picklist 值
values/label	string	picklist 值顯示名稱

更新或新增下拉列表項 4.6

• API 地址：metadata/picklist-edit
• HTTP 方法：POST
• 授權方式：通用授權

請求參數

參數	類型	是否必須	參數說明
entity	string	是	實體內部名稱
field	string	是	字段內部名稱，必須是 picklist 類型字段
value	int	否	picklist 值。用于匹配已有 picklist 項，匹配到則更新，未填（或未匹配到）則新增
label	string	是	picklist 值顯示名稱。注意顯示名稱不能重復，若存在重復系統會返回錯誤

返回數據示例

{
  "error_code": 0,
  "error_msg": "調用成功",
  "data": {
    "field": "typeCode",
    "value": 2,
    "label": "正式客戶"
  }
}

返回數據說明

字段	類型	字段說明
field	string	字段內部名稱
value	int	picklist 值
label	string	picklist 值顯示名稱

移除下拉列表項 4.6

• API 地址：metadata/picklist-remove
• HTTP 方法：POST
• 授權方式：通用授權

請求參數

參數	類型	是否必須	參數說明
entity	string	是	實體內部名稱
field	string	是	字段內部名稱，必須是 picklist 類型字段
value	int	否	picklist 值
label	string	否	picklist 值顯示名稱。value 或 label 必須指定一個，用于匹配待移除項

返回數據示例

{
  "error_code": 0,
  "error_msg": "調用成功",
  "data": {
    "field": "typeCode",
    "value": 2
  }
}

返回數據說明

字段	類型	字段說明
field	string	字段內部名稱
value	int	被移除的 picklist 項，如未匹配到任何，則返回 -1