费控-维度分组增量查询接口
说明
该接口用于查询多维费控模块的维度分组列表，支持增量查询
注意事项：
接口地址
/api/openapi/cost/dim-groups/query
请求类型
POST
请求参数
请求参数示例
{
"dimensionType": "xxx",
"sinceUpdatedAt": 1700000000000,
"enabledOnly": true,
"pageNo": 1,
"pageSize": 20
}
请求参数说明
| 字段 |
类型 |
是否必填 |
说明 |
| dimensionType |
string |
必填 |
维度类型 |
| sinceUpdatedAt |
long |
非必填 |
增量时间戳，只返回该时间戳之后更新的数据（毫秒） |
| enabledOnly |
boolean |
非必填 |
是否只返回启用状态的分组 |
| pageNo |
integer |
非必填 |
页码，默认第1页 |
| pageSize |
integer |
非必填 |
每页条数 |
响应参数
响应参数成功示例
{
"code": "ACK",
"message": "",
"data": {
"items": [
{
"code": "xxx",
"name": "xxx",
"dimType": "xxx",
"isDefault": false,
"enabled": true,
"version": 1,
"remark": "xxx",
"updatedAt": 1700000000000,
"optionCount": 5
}
],
"pageNo": 1,
"pageSize": 20,
"total": 100
},
"errorCode": null,
"success": true
}
响应参数失败示例
{
"code": "NACK",
"message": "维度类型不能为空",
"data": null,
"errorCode": null,
"success": false
}
响应参数说明
| 字段 |
类型 |
说明 |
| items |
List\ |
维度分组列表 |
| pageNo |
integer |
当前页码 |
| pageSize |
integer |
每页条数 |
| total |
integer |
总条数 |
items 元素说明
| 字段 |
类型 |
说明 |
| code |
string |
分组编码 |
| name |
string |
分组名称 |
| dimType |
string |
维度类型 |
| isDefault |
boolean |
是否为默认分组 |
| enabled |
boolean |
是否启用 |
| version |
integer |
版本号 |
| remark |
string |
备注 |
| updatedAt |
long |
最后更新时间戳（毫秒） |
| optionCount |
integer |
分组下的选项数量 |
修改记录
2026-06-17：init.