10 KiB
10 KiB
枚举类型配置模块
API接口一览表
接口分类 | 接口描述 | API接口 | 权限 |
---|---|---|---|
2.1枚举类型配置 | 2.1.1新增枚举类型 | /api/enum/addEnumTypes | SYS_AUTHORITY_ID_DEVICE_MGR |
2.1.2新增枚举值 | /api/enum/addEnumValues | SYS_AUTHORITY_ID_DEVICE_MGR | |
2.1.3枚举值修改 | /api/enum/updateEnumValues | SYS_AUTHORITY_ID_DEVICE_MGR | |
2.1.4获取枚举类型列表 | /api/enum/queryEnumTypesList | ||
2.1.5获取枚举值列表 | /api/enum/queryEnumValuesList | ||
2.1.6删除枚举值 | /api/enum/deleteEnumValues | SYS_AUTHORITY_ID_DEVICE_MGR | |
2.1.7修改枚举类型 | /api/enum/updateEnumTypes | SYS_AUTHORITY_ID_DEVICE_MGR | |
2.1.8删除枚举类型 | /api/enum/deleteEnumTypes | SYS_AUTHORITY_ID_DEVICE_MGR | |
2.1.9获取枚举字典 | /api/enum/getEnumDict |
2.1 枚举类型配置相关接口
2.1.1 新增枚举类型
POST 请求接口
/api/enum/addEnumTypes
请求参数
{
"name": "testEnum",
"description": "测试枚举类型"
}
入参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
name | String | NO | 枚举类型名称 |
description | String | NO | 枚举描述 |
返回报文
{
"code": 200,
"success": true,
"data": {
"id": "1849346211333619713",
"name": "testEnum",
"description": "测试枚举类型"
},
"msg": "操作成功"
}
返参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | String | 否 | id |
name | String | 否 | 枚举类型名称 |
description | String | 否 | 枚举描述 |
2.1.2 新增枚举值
POST 请求接口
/api/enum/addEnumValues
请求参数
{
"enumTypeId": 1849346211333619713,
"value": "testenum1",
"description": "测试枚举值1",
"isActive": 1,
"orderNumber": 1
}
入参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
enumTypeId | Long | NO | 枚举类型id |
value | String | NO | 枚举值内容 |
description | String | NO | 枚举值描述 |
isActive | Integer | NO | 是否有效(0:无效,1:有效) |
orderNumber | Integer | NO | 排序 |
返回报文
{
"code": 200,
"success": true,
"data": {
"id": "1849347701024608258",
"enumTypeId": 1849346211333619713,
"value": "testenum1",
"description": "测试枚举值1",
"orderNumber": 1,
"isActive": 1
},
"msg": "操作成功"
}
返参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | String | 否 | id |
enumTypeId | Long | 否 | 枚举类型id |
value | String | 否 | 枚举值内容 |
description | String | 否 | 枚举值描述 |
isActive | Integer | 否 | 是否有效(0:无效,1:有效) |
orderNumber | Integer | 否 | 排序 |
2.1.3 枚举值修改
POST 请求接口
/api/enum/updateEnumValues
请求参数
{
"id": 1849347701024608258,
"enumTypeId": 1849346211333619713,
"value": "testenum2",
"description": "测试枚举值2",
"isActive": 1,
"orderNumber": 1
}
入参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | Long | NO | 枚举值id |
enumTypeId | Long | NO | 枚举类型id |
value | String | YES | 枚举值内容 |
description | String | YES | 枚举值描述 |
isActive | Integer | YES | 是否有效(0:无效,1:有效) |
orderNumber | Integer | YES | 排序 |
返回报文
{
"code": 200,
"success": true,
"data": {
"id": "1849347701024608258",
"enumTypeId": 1849346211333619713,
"value": "testenum2",
"description": "测试枚举值2",
"orderNumber": 1,
"isActive": 1
},
"msg": "操作成功"
}
返参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | String | 否 | id |
enumTypeId | Long | 否 | 枚举类型id |
value | String | 否 | 枚举值内容 |
description | String | 否 | 枚举值描述 |
isActive | Integer | 否 | 是否有效(0:无效,1:有效) |
orderNumber | Integer | 否 | 排序 |
2.1.4 获取枚举类型列表
POST 请求接口
/api/enum/queryEnumTypesList
请求参数 无
返回报文
{
"code": 200,
"success": true,
"data": [
{
"id": "1",
"name": "iTurbineOperationMode",
"description": "运行模式"
},
{
"id": "2",
"name": "iBPLevel",
"description": "刹车等级"
}
],
"msg": "操作成功"
}
返参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | String | 否 | id |
name | String | 否 | 枚举类型名称 |
description | String | 否 | 枚举值描述 |
2.1.5 获取枚举值列表
POST 请求接口
/api/enum/queryEnumValuesList
请求参数
{
"pageNum":1,
"pageSize":20,
"description": "通讯断开",
"enumTypeId": "1"
}
入参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
pageNum | Integer | NO | 当前页 |
pageSize | Integer | NO | 每页显示大小 |
description | String | YES | 枚举值描述 |
enumTypeId | String | NO | 枚举值类型id |
返回报文
{
"code": 200,
"success": true,
"data": {
"total": 1,
"rows": [
{
"id": "1000",
"enumTypeId": 1,
"enumTypeIdStr": "1",
"value": "0",
"description": "通讯断开",
"orderNumber": 1,
"isActive": 1
}
],
"code": 200,
"msg": "查询成功"
},
"msg": "操作成功"
}
返参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | String | 否 | id |
enumTypeId | Long | 否 | 枚举类型id |
enumTypeIdStr | String | 否 | 枚举类型id(字符串类型) |
value | String | 否 | 枚举值内容 |
description | String | 否 | 枚举值描述 |
isActive | Integer | 否 | 是否有效(0:无效,1:有效) |
orderNumber | Integer | 否 | 排序 |
2.1.6 删除枚举值
POST 请求接口
/api/enum/deleteEnumValues
请求参数
{
"id":"1849347701024608258"
}
入参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | String | NO | 枚举值id |
返回报文
{
"code": 200,
"success": true,
"msg": "操作成功"
}
2.1.7 修改枚举类型
POST 请求接口
/api/enum/updateEnumTypes
请求参数
{
"id":1849361189939826689,
"name": "testEnum3",
"description": "测试枚举类型3"
}
入参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | Long | NO | 枚举类型id |
name | String | YES | 枚举类型名称 |
description | String | YES | 枚举类型描述 |
返回报文
{
"code": 200,
"success": true,
"data": {
"id": "1849361189939826689",
"name": "testEnum3",
"description": "测试枚举类型3"
},
"msg": "操作成功"
}
返参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | Long | 否 | 枚举类型id |
name | String | 否 | 枚举类型名称 |
description | String | 否 | 枚举类型描述 |
2.1.8 删除枚举类型
POST 请求接口
/api/enum/deleteEnumTypes
请求参数
{
"id":1849361189939826689
}
入参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
id | Long | NO | 枚举类型id |
返回报文
{
"code": 200,
"success": true,
"msg": "操作成功"
}
2.1.9获取枚举字典
POST 请求接口
/api/enum/getEnumDict
请求参数
无
返回报文
{
"code": 200,
"success": true,
"data": [
{
"name": "iTurbineOperationMode",
"description": "运行模式",
"enumValues": {
"0": "通讯断开",
"1": "紧急停机",
"2": "安全链停机",
"3": "199刹车停机",
"4": "198刹车停机"
}
},
{
"name": "iBPLevel",
"description": "刹车等级",
"enumValues": {
"0": "无故障",
"30": "限功率",
"50": "降转速"
}
},
{
"name": "iYPLevel",
"description": "偏航运行模式",
"enumValues": {
"0": "自动偏航",
"5": "自动解缆时待机",
"10": "自动解缆",
"20": "偏航节能"
}
},
{
"name": "ActiveStatusCode",
"description": "故障代码",
"enumValues": {
"16842753": "01_01_001风机由于变桨系统安全链断开导致机组急停",
"16973825": "01_03_001风机轮毂温度>60℃",
"16973826": "01_03_002风机轮毂温度<-20℃",
"16973827": "01_03_003风机轮毂温度>50℃,24小时内允许出现3次"
}
}
],
"msg": "操作成功"
}
返参描述
参数名 | 参数类型 | 可选 | 描述 |
---|---|---|---|
name | String | 否 | 枚举类型名称 |
description | String | 否 | 枚举类型描述 |
enumValues | Map<String,String> map | 否 | 枚举类型值集合 |