下拉列表数据

获取下拉列表数据

• 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