map/docs/api/enumPage.md
2024-11-06 15:04:51 +08:00

10 KiB
Raw Blame History

枚举类型配置模块

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 枚举类型值集合