下拉列表數據
獲取下拉列表數據
- 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 |