接口描述
可查询当前appId下自定义的全部控件组列表信息,可查询某个具体的控件组ID/控件组名称,也可根据控件ID查询其所在的控件组。
接口地址&请求方法
接口地址:https://{host}/v3/custom-component-group/get-list
请求方法:POST
请求头格式
具体请求头参数,请查看公共请求头格式。
请求参数
参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 | |
pageNum | int | 是 | body | 页码(大于0,最小值为1) | |
pageSize | int | 是 | body | 每页展示的数量(可选范围[1~100]) | |
componentGroupId | string | 否 | body | 控件组ID | |
componentName | string | 否 | body | 控件组名称 | |
componentId | string | 否 | body | 控件ID 可根据控件ID查询其所在的控件组 |
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | ||||
code | int32 | 是 | 业务码,0表示成功,非0表示异常。 | ||||
message | string | 否 | 业务信息 请根据 code 来判断错误情况,不应该依赖 message匹配,因为 message 可能会调整。 | ||||
data | object | 否 | 业务信息 | ||||
componentGroups | array | 否 | 控件组列表 | ||||
componentGroupId | string | 否 | 控件组ID | ||||
componentGroupName | string | 否 | 控件组名称 | ||||
componentGroupOrder | int | 否 | 控件组展示顺序 |
请求示例
{ | |
"pageNum": "1", | |
"pageSize": "20" | |
} |
响应示例
{ | |
"code": 0, | |
"message": "成功", | |
"data": { | |
"componentGroups": [ | |
{ | |
"componentGroupId": "6c58030*****9c959ace19719", | |
"componentGroupName": "控件组名称1", | |
"componentGroupOrder": 1 | |
}, | |
{ | |
"componentGroupId": "08cec****7ff3c", | |
"componentGroupName": "控件组名称2", | |
"componentGroupOrder": 1 | |
} | |
], | |
"total": 2 | |
} | |
} |
错误码
code 错误码 | message 错误信息 | 解决方案 |
1430002 | 参数错误 | 检查对应的参数是否符合格式 |
1430012 | 服务异常 | 检查接口整体的参数格式是否正确 |