组态标准api
大约 63 分钟
组态标准api
Base URLs:
Authentication
- HTTP Authentication, scheme: bearer
组态
GET 获取组态列表
GET /api/zutai/page/list
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| pageNum | query | integer | 是 | 当前页，默认值1 |
| pageSize | query | integer | 是 | 页容量，默认值10 |
| pageName | query | string | 否 | 组态名称，模糊查询组态名称 |
| isShow | query | integer | 否 | 是否展示，值取0或1 |
| station_id | query | integer | 否 | 站点编号，若为空返回所有 |
| user_id | query | string | 是 | 用户id |
返回示例
200 Response
{
"code": 0,
"msg": "string",
"rows": [
{
"id": 0,
"guid": "string",
"createTime": "string",
"userId": 0,
"pageName": "string",
"deviceZtData": "string",
"pageImage": "string",
"pageSize": "string",
"base64": "string",
"sort": 0,
"remark": "string",
"isShow": 0,
"isCache": true,
"isShare": true,
"shareUrl": "string",
"sharePass": "string",
"station_id": "string"
}
],
"total": 0
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none | |
| » rows | [object] | true | none | none | |
| »» id | integer | true | none | 组态id | |
| »» guid | string | true | none | 组态guid | |
| »» createTime | string¦null | false | none | 创建时间 | |
| »» userId | integer | true | none | 创建人id | |
| »» pageName | string | true | none | 组态名称 | |
| »» deviceZtData | string¦null | false | none | 组态data | |
| »» pageImage | string¦null | false | none | 页面图片，保存图片请求地址 | |
| »» pageSize | string | true | none | 组态分辨率 | |
| »» base64 | string | true | none | 缩略图 | |
| »» sort | integer | true | none | 排序，值越大显示顺序越靠前 | |
| »» remark | string¦null | false | none | 备注 | |
| »» isShow | integer | true | none | 是否展示，0不展示，1为展示 | |
| »» isCache | boolean | false | none | 是否缓存，默认为false | |
| »» isShare | boolean¦null | false | none | 是否分享 | |
| »» shareUrl | string¦null | false | none | 分享链接 | |
| »» sharePass | string¦null | false | none | 分享密码 | |
| »» station_id | string | true | none | 站点id | |
| » total | integer | true | none | 组态总数量 |
POST 创建组态
POST /api/zutai/page/create
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| pageImage | query | string | 是 | 组态封面图片（资源存放路径） |
| pageName | query | string | 是 | 组态名称 |
| pageSize | query | string | 是 | 分辨率 |
| isShow | query | integer | 否 | 是否展示，默认0 |
| sort | query | integer | 否 | 排序，在0-999之间，默认0 |
| station_id | query | integer | 否 | 站点id，若为空不保存 |
| user_id | query | string | 否 | 用户id |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
GET 获取组态详情
GET /api/zutai/page/detail
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| guid | query | string | 是 | 组态guid |
| user_id | query | string | 是 | 用户id |
返回示例
200 Response
{
"msg": "操作成功",
"code": 200,
"data": {
"createBy": "admin",
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1702592445721894966",
"deptIdStrs": null,
"deviceMac": null,
"deviceName": null,
"deviceZtData": null,
"bindList": null,
"isCache": false,
"isMainPage": null,
"pageName": "12",
"pageSize": "960x600",
"isShare": null,
"shareUrl": null,
"sharePass": null,
"pageImage": "/profile/upload/2024/10/15/`%_8CJ6GVFQ~45QD_JBAL(B_20241015192713A061.png",
"isOnline": true,
"paramDoubleQuery": null,
"queryDeptId": null,
"base64": null,
"userId": null,
"guid": "ecb91c98-ee72-4bbf-9979-f6ecb332528a",
"bdeviceManager": null
}
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » msg | string | true | none | none | |
| » code | integer | true | none | none | |
| » data | object | true | none | none | |
| »» id | integer | true | none | 组态id | |
| »» station_id | integer | false | none | 站点id，可为空 | |
| »» guid | string | true | none | 组态guid | |
| »» createTime | string¦null | false | none | 创建时间 | |
| »» userId | integer | true | none | 创建用户id | |
| »» pageName | string | true | none | 组态名称 | |
| »» pageImage | string¦null | false | none | 组态封面图片（地址） | |
| »» pageSize | string | true | none | 组态分辨率 | |
| »» base64 | string¦null | false | none | 缩略图 | |
| »» deviceZtData | string¦null | false | none | 组态data | |
| »» remark | string¦null | false | none | 备注 | |
| »» isShow | integer | true | none | 是否展示 | |
| »» isCache | boolean¦null | false | none | 是否缓存 | |
| »» isShare | boolean¦null | false | none | 是否可分享 | |
| »» sharePass | string¦null | false | none | 分享密码 | |
| »» shareUrl | string¦null | false | none | 分享链接 |
POST 修改组态
POST /api/zutai/page/update
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| guid | query | integer | 是 | 组态id |
| pageImage | query | string | 是 | 组态封面图片地址 |
| pageName | query | string | 是 | 组态名称 |
| pageSize | query | string | 是 | 分辨率 |
| isShow | query | integer | 否 | 是否展示，空值默认为0 |
| sort | query | integer | 否 | 排序，在0-999之间，默认0 |
| user_id | query | string | 是 | 用户id |
返回示例
200 Response
{
"msg": "操作成功",
"code": 200
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » msg | string | true | none | none | |
| » code | integer | true | none | none |
POST 保存组态（编辑器）
POST /api/zutai/page/saveZt
Body 请求参数
guid: ""
deviceZtData: ""
pageSize: ""
user_id: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » guid | body | string | 是 | none |
| » deviceZtData | body | string | 是 | none |
| » pageSize | body | string | 否 | 分辨率 |
| » user_id | body | string | 是 | 用户id |
返回示例
200 Response
{
"code": 0,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
POST 复制组态
POST /api/zutai/page/createCopy
创建一个新的组态，完全从另一个组态复制
Body 请求参数
pageImage: ""
pageName: ""
guid: ""
pageSize: ""
deviceZtData: ""
station_id: 0
user_id: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » pageImage | body | string | 是 | 组态封面图片地址 |
| » pageName | body | string | 是 | 组态名称 |
| » guid | body | string | 否 | 复制源组态guid |
| » pageSize | body | string | 是 | 组态分辨率 |
| » deviceZtData | body | string | 否 | 组态配置 |
| » station_id | body | integer | 否 | 站点id |
| » user_id | body | string | 否 | 用户id |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
POST 删除组态
POST /api/zutai/page/delete
支持批量删除
Body 请求参数
guid: ""
user_id: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » guid | body | string | 是 | 组态id，多个组态guid用;隔开 |
| » user_id | body | string | 是 | 用户id |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
POST 保存组态缩略图
POST /api/zutai/page/saveZtImage
Body 请求参数
guid: ""
base64: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » guid | body | string | 是 | 组态guid |
| » base64 | body | string | 是 | 缩略图，格式为二进制数组[]byte |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
图库
GET 获取图库分类
GET /api/zutai/system/dict/data/type/sys_image_type
移除cssClass、listClass、isDefault、status、default
返回示例
200 Response
{
"msg": "string",
"code": 0,
"data": [
{
"dictCode": 0,
"dictValue": "string",
"dictLabel": "string",
"dictLabel_zh_CN": "string",
"dictLabel_en_US": "string",
"dictType": "string",
"dictSort": 0,
"createBy": 0,
"createTime": "string",
"remark": "string"
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » msg | string | true | none | none | |
| » code | integer | true | none | none | |
| » data | [object] | true | none | none | |
| »» dictCode | integer | true | none | 分类Code | |
| »» dictValue | string | true | none | 分类value | |
| »» dictLabel | string | true | none | 名称 | |
| »» dictLabel_zh_CN | string | false | none | 中文名称 | |
| »» dictLabel_en_US | string | false | none | 英文名称 | |
| »» dictType | string | true | none | 字典类型，图库类型标识：sys_image_type | |
| »» dictSort | integer | true | none | 排序 | |
| »» createBy | integer | false | none | 创建人 | |
| »» createTime | string | false | none | 创建时间 | |
| »» remark | string | false | none | 备注 |
GET 获取图库分类选项
GET /api/zutai/upload/getImageType
id的格式为：1000+index+'-'+dictValue，即如果查询出5个类型，第一个类型的dictValue为按钮，它的id是“1001-按钮”（可以无视这段说明，前端修改）
需确定id
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| lang | query | string | 否 | 名称显示语言，默认为中文 |
| user_id | query | integer | 否 | 用户id |
返回示例
200 Response
{
"msg": "string",
"code": 0,
"data": [
{
"id": "string",
"title": "string",
"number": 0
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » msg | string | true | none | none | |
| » code | integer | true | none | none | |
| » data | [object] | true | none | none | |
| »» id | string | true | none | 选项标识，结构为${dictCode}-$ | |
| »» title | string | true | none | 选项中显示的名称，默认取中文名称 | |
| »» number | integer | true | none | 该分类下图库数量 |
GET 获取图库列表
GET /api/zutai/upload/list
移除moduleGuid，userId、versionCode、versionName
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| pageNum | query | integer | 是 | 查询页 |
| pageSize | query | integer | 是 | 页容量 |
| moduleName | query | string | 是 | 查询的目标分类，对应分类里的dictValue |
| orderByColumn | query | string | 否 | 查询结果排序字段 |
| isAsc | query | string | 否 | 排序方式 |
| fileName | query | string | 否 | 图库名称模糊查询关键词 |
| user_id | query | integer | 是 | 用户id |
返回示例
200 Response
{
"msg": "string",
"code": 0,
"total": 0,
"rows": [
{
"id": "string",
"fileName": "string",
"createBy": "string",
"createTime": "string",
"remark": "string",
"moduleName": "string",
"resourceUrl": "string"
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » msg | string | true | none | none | |
| » code | integer | true | none | none | |
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» id | string | true | none | none | |
| »» fileName | string | true | none | 名称 | |
| »» createBy | string | false | none | 创建人 | |
| »» createTime | string | false | none | 创建时间 | |
| »» remark | string | false | none | 备注 | |
| »» moduleName | string | true | none | 图库所属分类 | |
| »» resourceUrl | string | true | none | 资源url |
POST 创建（上传）系统图库的组件
POST /api/zutai/upload/uploadData
请求参数不携带图库名称，可以以上传文件名称或平台统一格式的默认名称等配置图库名称
Body 请求参数
file: ""
user_id: 0请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| moduleName | query | string | 是 | 分类名称 |
| body | body | object | 否 | none |
| » file | body | string(binary) | 是 | none |
| » user_id | body | integer | 否 | none |
返回示例
200 Response
{
"code": 0,
"msg": "上传成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
POST 修改系统图库组件
POST /api/zutai/upload/update
备注：用于修改名称和类型
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| fileName | query | string | 是 | 组件名称 |
| id | query | integer | 是 | 组件id |
| moduleName | query | string | 是 | 组件分类，即dictValue |
| user_id | query | string | 是 | none |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
POST 删除图库组件
POST /api/zutai/upload/delete
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| id | query | integer | 是 | 图库组件id |
| user_id | query | string | 否 | none |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
POST 添加收藏
POST /api/zutai/upload/collect
备注：和上传相比，上传是上传一个文件并创建组件，收藏是直接使用已有组件的资源地址、组件名等重新创建一个组件（无需上传，使用已有的资源地址），并且moduleName==='我的收藏'
Body 请求参数
moduleName: ""
resourceUrl: ""
fileName: ""
user_id: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » moduleName | body | string | 是 | 固定值，“我的收藏” |
| » resourceUrl | body | string | 是 | 资源url |
| » fileName | body | string | 是 | 名称 |
| » user_id | body | string | 否 | none |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
模板
POST 新增模板
POST /api/zutai/template/add
Body 请求参数
user_id: 0
configuration: ""
image: ""
name: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » user_id | body | integer | 是 | none |
| » configuration | body | string | 是 | 组件配置，json格式 |
| » image | body | string | 否 | 模板图片 |
| » name | body | string | 否 | 模板名称 |
返回示例
200 Response
{
"code": 0,
"message": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none |
POST 修改模板
POST /api/zutai/template/update
Body 请求参数
user_id: 0
name: ""
id: 0
sort: 0请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » user_id | body | integer | 是 | none |
| » name | body | string | 否 | 模板名称 |
| » id | body | integer | 否 | 模板id |
| » sort | body | integer | 否 | 排序 |
返回示例
200 Response
{
"code": 0,
"message": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none |
POST 删除模板
POST /api/zutai/template/delete
Body 请求参数
user_id: 0
id: 0请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » user_id | body | integer | 是 | none |
| » id | body | integer | 否 | 模板id |
返回示例
200 Response
{
"code": 0,
"message": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none |
GET 获取模板列表
GET /api/zutai/template/list
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| user_id | query | integer | 否 | none |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": [
{
"id": "string",
"confifuration": "string",
"name": "string",
"image": "string",
"sort": "string"
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» id | string | true | none | ID 编号 | |
| »» confifuration | string | true | none | none | |
| »» name | string | true | none | none | |
| »» image | string | true | none | none | |
| »» sort | string | true | none | none |
设备
GET 获取设备列表
GET /api/zutai/device/list
备注：设备deviceMac和测点的paramField标识唯一测点，在数据模块用于获取数据,paramField由测点类型+"_"+测点id组成，如analog_12
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| pageNum | query | integer | 是 | 查询页，默认值1 |
| pageSize | query | integer | 是 | 页容量，默认值999 |
| deviceName | query | string | 否 | 设备名称，用于模糊查询设备名称 |
| deviceMac | query | string | 否 | 设备id |
| station_id | query | string | 否 | 站点id |
返回示例
200 Response
{
"total": 89,
"rows": [
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "186",
"reportTime": null,
"deviceMac": "11010100001320000001",
"deviceCard": null,
"deviceName": "视频监控01",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": 121.480539,
"latitude": 31.235929,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "531",
"reportTime": null,
"deviceMac": "41082300001320000001",
"deviceCard": null,
"deviceName": "若初测试摄像头",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": 113.248548,
"latitude": 35.220963,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "573",
"reportTime": null,
"deviceMac": "E098068F2CBB",
"deviceCard": null,
"deviceName": "温湿度传感器-延凡82",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": 104.600295,
"latitude": 36.332028,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "577",
"reportTime": null,
"deviceMac": "D17Y216411KE",
"deviceCard": null,
"deviceName": "电表080",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": 121.480539,
"latitude": 31.235929,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "580",
"reportTime": null,
"deviceMac": "483FDA4B29D7",
"deviceCard": null,
"deviceName": "温湿度传感器-延凡83",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": 101.544281,
"latitude": 28.890369,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "581",
"reportTime": null,
"deviceMac": "D930LW46HNSPY",
"deviceCard": null,
"deviceName": "4-IRman1",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": null,
"latitude": null,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "582",
"reportTime": null,
"deviceMac": "D9306R0M92PF7",
"deviceCard": null,
"deviceName": "4-IRman2",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": null,
"latitude": null,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "583",
"reportTime": null,
"deviceMac": "D936A5ANUT576",
"deviceCard": null,
"deviceName": "4-IRman3",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": 114.311582,
"latitude": 30.598467,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "584",
"reportTime": null,
"deviceMac": "D936Z475Y54D6",
"deviceCard": null,
"deviceName": "4-IRman4",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": null,
"latitude": null,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": null,
"guid": "585",
"reportTime": null,
"deviceMac": "D93R5C6F55P27",
"deviceCard": null,
"deviceName": "DS-K2904-1",
"deviceType": null,
"deviceModel": null,
"deviceStatus": null,
"installationTime": null,
"installationAddress": null,
"longitude": null,
"latitude": null,
"isLocation": null,
"deviceQuery": null,
"paramList": null,
"deviceDetail": null,
"deviceContro": null,
"queryTime": null,
"queryParam": null,
"isWarn": null,
"queryType": null,
"refreshTime": null,
"isShare": null,
"shareUrl": null,
"step": null,
"queryEmqxStatus": false,
"hardwareModel": null,
"firmwareVersion": null,
"firmwareVersionNew": null,
"firmwareUrl": null,
"upgradeExplain": null,
"deviceSignal": null,
"networkModel": null,
"gatewayModel": null,
"queryDeptId": null,
"percentage": null,
"vpnState": null,
"upgradeModel": null,
"scriptGuid": null,
"deptIdStrs": null
}
],
"code": 200,
"msg": "查询成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | 总数 | |
| » rows | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备id，标识唯一设备（注，可以不使用id但需要保证是唯一标识且可以用于查询，保持全程统一） | |
| »» deviceName | string | true | none | 设备名称 | |
| »» deviceType | string | true | none | 设备类型 | |
| »» deviceModel | string | true | none | 设备型号 | |
| »» deviceStatus | integer | true | none | 设备状态（1在线2报警0离线） | |
| »» remark | string¦null | false | none | 备注 | |
| »» longitude | number¦null | false | none | 经度 | |
| »» latitude | number¦null | false | none | 纬度 | |
| » code | integer | false | none | none | |
| » msg | string | true | none | none |
枚举值
| 属性 | 值 |
|---|---|
| deviceStatus | 0 |
| deviceStatus | 1 |
| deviceStatus | 2 |
GET 获取设备详情
GET /api/zutai/device/detail
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMac | query | string | 是 | 设备id |
返回示例
200 Response
{
"code": "200",
"msg": "查询成功",
"data": {
"deviceStatus": 2,
"deviceMac": "string",
"deviceName": "string",
"installationAddress": "string",
"longitude": "string",
"latitude": "string"
}
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none | |
| » data | object | true | none | none | |
| »» deviceStatus | integer | false | none | 1在线2报警0离线 | |
| »» deviceMac | string | true | none | 设备id | |
| »» deviceName | string | true | none | 设备名称 | |
| »» installationAddress | string¦null | false | none | 设备所在地 | |
| »» longitude | string | true | none | lng | |
| »» latitude | string | true | none | lat |
GET 获取组态已绑定的设备
GET /api/zutai/device/getBindList
移除productId
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| guid | query | string | 是 | 组态guid |
| deviceName | query | string | 否 | 设备名称，用于模糊查询设备名称 |
返回示例
200 Response
{
"total": 0,
"onLineNumber": 0,
"offLineNumber": 0,
"warnNumber": 0,
"rows": [
{
"id": 0,
"deviceMac": "string",
"deviceName": "string",
"remark": "string",
"ztGuid": "string",
"status": 0,
"logitude": "string",
"latitude": "string"
}
],
"code": 0,
"msg": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » onLineNumber | integer | true | none | 在线数量‘ | none |
| » offLineNumber | integer | true | none | 离线数量 | none |
| » warnNumber | integer | true | none | 报警数量 | none |
| » rows | [object] | true | none | none | |
| »» id | integer | true | none | 绑定关系id | |
| »» deviceMac | string | true | none | 设备id | |
| »» deviceName | string¦null | true | none | 设备名称 | |
| »» remark | string | false | none | 备注 | |
| »» ztGuid | string | true | none | 查询组态的guid | |
| »» status | integer¦null | false | none | 设备状态 | |
| »» logitude | string¦null | false | none | none | |
| »» latitude | string¦null | false | none | none | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
POST 绑定设备
POST /api/zutai/device/bind
Body 请求参数
deviceMac: ""
ztGuid: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » deviceMac | body | string | 是 | 设备id |
| » ztGuid | body | string | 是 | 组态guid |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
POST 移除绑定关系
POST /api/zutai/device/deleteBind
Body 请求参数
id: 0请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » id | body | integer | 是 | 绑定关系id |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
GET 获取设备所有测点
GET /api/zutai/device/optionData
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMac | query | integer | 是 | 设备标识符 |
| searchKey | query | string | 否 | 查询关键词 |
| type | query | string | 否 | 测点类型，用于筛选测点类型，analog,accumulator,status |
返回示例
200 Response
{
"total": 8,
"rows": [
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257608",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "41082300001320000001",
"deviceName": "若初测试摄像头",
"paramName": null,
"paramField": null,
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "灯光色值",
"paramField": "light_color",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "屏幕消息",
"paramField": "message",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "空气温度",
"paramField": "temperature",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "空气湿度",
"paramField": "humidity",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "设备开关",
"paramField": "switch",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "未知01",
"paramField": "co2",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "未知02",
"paramField": "brightness",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
}
],
"code": 200,
"msg": "查询成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » data | [object] | true | none | none | |
| »» paramField | string | true | none | 测点标识 | |
| »» paramName | string¦null | true | none | 测点名称 | |
| »» paramUnit | string¦null | false | none | 测点单位 | |
| »» readWriteType | string | true | none | 测点类型，analog,accumulator,status | |
| »» remark | string¦null | false | none | 备注 | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
GET 获取组态已绑定设备的所有测点
GET /api/zutai/device/getBindDataList
deviceImei-->deviceMac
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| pageNum | query | integer | 是 | 查询页，默认值1 |
| pageSize | query | integer | 是 | 页容量，默认值999 |
| orderByColumn | query | string | 否 | 排序列，根据此列进行升降序排序 |
| isAsc | query | string | 否 | 排序方式，asc/desc |
| ztGuid | query | string | 是 | 组态guid |
| paramName | query | string | 否 | 测点名称，用于模糊查询测点名称 |
| readWriteType | query | string | 否 | 测点类型，用于筛选测点类型，analog,accumulator,status |
返回示例
200 Response
{
"total": 0,
"rows": [
{
"deviceMac": "string",
"deviceName": "string",
"paramName": "string",
"paramValue": "string",
"paramField": "string",
"readWriteType": "analog",
"paramUnit": "string",
"remark": "string",
"id": 0,
"ztGuid": "string",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
],
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» paramName | string | true | none | 测点名称 | |
| »» paramValue | any | false | none | 测点值，此接口可不返回 |
oneOf
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | string | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | integer | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | boolean | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | array | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | object | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | number | false | none | none |
continued
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »» paramField | string | true | none | 测点标识 | |
| »» readWriteType | string | true | none | 测点类型，analog,accumulator,status | |
| »» paramUnit | string¦null | false | none | 测点单位 | |
| »» remark | string¦null | false | none | 备注 | |
| »» id | integer | true | none | 设备绑定关系id | |
| »» ztGuid | string | true | none | 组态id | |
| »» dataType | string¦null | false | none | 数据类型，无符号16位，有符号16位等 | |
| »» acquisitionFormula | string¦null | false | none | 读取数据的处理公式 | |
| »» writeFormula | string¦null | false | none | 写入数据的处理公式 | |
| »» writeUp | number¦null | false | none | 上限 | |
| »» writeLow | number¦null | false | none | 下限 | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
枚举值
| 属性 | 值 |
|---|---|
| readWriteType | analog |
| readWriteType | accumulator |
| readWriteType | status |
GET 获取组态已绑定设备的所有测点(树结构)
GET /api/zutai/device/getBindDataTree
deviceImei-->deviceMac
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| ztGuid | query | string | 是 | 组态guid |
| paramName | query | string | 否 | 测点名称，用于模糊查询测点名称 |
| readWriteType | query | string | 否 | 测点类型，用于筛选测点类型，analog,accumulator,status |
返回示例
200 Response
{
"total": 0,
"rows": [
{
"deviceMac": "string",
"deviceName": "string",
"disabled": "true",
"nodeKey": "string",
"children": [
{
"nodeKey": "string",
"deviceMac": 0,
"paramField": "string",
"paramName": "string",
"paramValue": "string",
"paramUnit": "string",
"ztGuid": "string",
"id": 0,
"remark": "string",
"readWriteType": "anolog",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
]
}
],
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» disabled | boolean | true | none | 固定值true | |
| »» nodeKey | string | true | none | 用于nodeKey，值为deviceMac | |
| »» children | [object] | false | none | 测点列表 | |
| »»» nodeKey | string | true | none | 用作nodeKey,值为{deviceMac}_{deviceField},如2_analog_2 | |
| »»» deviceMac | integer | true | none | 设备标识符 | |
| »»» paramField | string | true | none | 测点标识 | |
| »»» paramName | string | true | none | 测点名称 | |
| »»» paramValue | string | true | none | 测点值，此接口可不返回 | |
| »»» paramUnit | string¦null | false | none | 测点单位 | |
| »»» ztGuid | string | true | none | 组态id | |
| »»» id | integer | true | none | 设备绑定关系id | |
| »»» remark | string¦null | false | none | 备注 | |
| »»» readWriteType | string | true | none | 测点类型，analog,accumulator,status | |
| »»» dataType | string¦null | false | none | 数据类型，无符号16位，有符号16位等 | |
| »»» acquisitionFormula | string¦null | false | none | 读取数据的处理公式 | |
| »»» writeFormula | string¦null | false | none | 写入数据的处理公式 | |
| »»» writeUp | number¦null | false | none | 上限 | |
| »»» writeLow | number¦null | false | none | 下限 | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
枚举值
| 属性 | 值 |
|---|---|
| readWriteType | anolog |
| readWriteType | accumulator |
| readWriteType | status |
GET 获取组态已绑定设备所有可控测点
GET /api/zutai/device/getBindControlDataList
查询可控制测点列表;deviceImei->deviceMac
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| pageNum | query | integer | 否 | 当前页数，默认值1 |
| pageSize | query | integer | 否 | 页容量，默认值999 |
| orderByColumn | query | string | 否 | 排序列，以该字段列为排序基准，控制查询数据升序、降序 |
| isAsc | query | string | 否 | 是否升序排序 |
| ztGuid | query | string | 是 | 组态guid |
| controlType | query | integer | 否 | 控制类型，空值默认为1，1标识遥信2标识遥测 |
| paramName | query | string | 否 | 查询关键字，测点名称模糊查询 |
返回示例
200 Response
{
"total": 8,
"rows": [
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257608",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "41082300001320000001",
"deviceName": "若初测试摄像头",
"paramName": null,
"paramField": null,
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "灯光色值",
"paramField": "light_color",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "屏幕消息",
"paramField": "message",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "空气温度",
"paramField": "temperature",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "空气湿度",
"paramField": "humidity",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "设备开关",
"paramField": "switch",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "未知01",
"paramField": "co2",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "未知02",
"paramField": "brightness",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
}
],
"code": 200,
"msg": "查询成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» paramName | string¦null | true | none | 测点名称 | |
| »» paramValue | any | true | none | 测点值，此接口可不返回 |
oneOf
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | string | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | integer | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | boolean | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | array | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | object | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | number | false | none | none |
continued
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »» paramField | string¦null | true | none | 测点标识 | |
| »» readWriteType | string | true | none | 测点类型，analog,accumulator,status | |
| »» paramUnit | string¦null | false | none | 测点单位 | |
| »» remark | string¦null | false | none | 备注 | |
| »» id | integer | true | none | 设备绑定关系id | |
| »» ztGuid | string | true | none | 组态guid | |
| »» dataType | string¦null | false | none | 数据类型，无符号16位，有符号16位等 | |
| »» acquisitionFormula | string¦null | false | none | 读取数据的处理公式 | |
| »» writeFormula | string¦null | false | none | 写入数据的处理公式 | |
| »» writeUp | string¦null | false | none | 上限 | |
| »» writeLow | string¦null | false | none | 下限 | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
枚举值
| 属性 | 值 |
|---|---|
| readWriteType | analog |
| readWriteType | accumulator |
| readWriteType | status |
GET 获取组态已绑定设备所有可控测点 (树结构)
GET /api/zutai/device/getBindControlDataTree
不再获取遥信，只获取遥控点
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| ztGuid | query | string | 是 | 组态guid |
| paramName | query | string | 否 | 测点名称，用于模糊查询测点名称 |
| controlType | query | string | 否 | 控制类型，空值默认为1，1标识遥信2标识遥测 |
返回示例
200 Response
{
"total": 8,
"rows": [
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257608",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "41082300001320000001",
"deviceName": "若初测试摄像头",
"paramName": null,
"paramField": null,
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "灯光色值",
"paramField": "light_color",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "屏幕消息",
"paramField": "message",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "空气温度",
"paramField": "temperature",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "空气湿度",
"paramField": "humidity",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "设备开关",
"paramField": "switch",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "未知01",
"paramField": "co2",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
},
{
"createBy": null,
"createTime": null,
"updateBy": null,
"updateTime": null,
"remark": null,
"id": "1733748412723257609",
"guid": null,
"deptIdStrs": null,
"reportTime": null,
"deviceImei": "E098068F2CBB",
"deviceName": "温湿度传感器-延凡82",
"paramName": "未知02",
"paramField": "brightness",
"paramValue": null,
"paramUnit": null,
"paramIcon": null,
"driveName": null,
"registerType": null,
"registerAddress": null,
"dataType": null,
"readWriteType": null,
"decimalPlaces": null,
"deadbandSet": null,
"acquisitionFormula": null,
"writeFormula": null,
"writeUp": null,
"writeLow": null,
"sort": null,
"minAcquisitionTime": null,
"comWaitingTime": null,
"aiUnit": null,
"aiType": null,
"scriptGuid": null,
"paramDoubleQuery": null,
"paramValueZc": null,
"parameterList": null,
"isQueryParam": true,
"imeiList": null,
"ztGuid": "6c30b1ac-3726-4f3f-b385-bce3e4bde353",
"didoType": null,
"isDiDo": null,
"isContro": null,
"paramNameList": null
}
],
"code": 200,
"msg": "查询成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» disabled | boolean | true | none | 固定值true | |
| »» nodeKey | string | true | none | 用于nodeKey，值为deviceMac | |
| »» children | [object] | false | none | 测点列表 | |
| »»» nodeKey | string | true | none | 用于nodeKey,值为{deviceImei}_{deviceField},如2_analog_2 | |
| »»» deviceMac | integer | true | none | 设备标识符 | |
| »»» paramField | string | true | none | 测点标识符 | |
| »»» paramName | string | true | none | 测点名称 | |
| »»» paramValue | string | true | none | 测点值，此接口可不返回 | |
| »»» paramUnit | string¦null | false | none | 测点单位 | |
| »»» id | integer | true | none | 设备绑定关系id | |
| »»» ztGuid | string | true | none | 组态id | |
| »»» remark | string¦null | false | none | 备注 | |
| »»» readWriteType | string | true | none | 测点类型，analog,accumulator,status | |
| »»» dataType | string¦null | false | none | 数据类型，无符号16位，有符号16位等 | |
| »»» acquisitionFormula | string¦null | false | none | 读取数据的处理公式 | |
| »»» writeFormula | string¦null | false | none | 写入数据的处理公式 | |
| »»» writeUp | number¦null | false | none | 上限 | |
| »»» writeLow | number¦null | false | none | 下限 | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
GET 获取组态已绑定设备的所有遥调测点
GET /api/zutai/device/getBindRemoteDataList
deviceImei-->deviceMac
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| pageNum | query | integer | 是 | 查询页，默认值1 |
| pageSize | query | integer | 否 | 页容量，默认值999 |
| orderByColumn | query | string | 否 | 排序列，根据此列进行升降序排序 |
| isAsc | query | string | 否 | 排序方式，asc/desc |
| ztGuid | query | string | 是 | 组态guid |
| paramName | query | string | 否 | 测点名称，用于模糊查询测点名称 |
返回示例
200 Response
{
"total": 0,
"rows": [
{
"deviceMac": 0,
"deviceName": "string",
"paramName": "string",
"paramValue": "string",
"paramField": "string",
"readWriteType": "analog",
"paramUnit": "string",
"remark": "string",
"id": 0,
"ztGuid": "string",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
],
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» deviceMac | integer | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» paramName | string | true | none | 测点名称 | |
| »» paramValue | any | false | none | 测点值，此接口可不返回 |
oneOf
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | string | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | integer | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | boolean | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | array | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | object | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | number | false | none | none |
continued
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »» paramField | string | true | none | 测点标识 | |
| »» readWriteType | string | true | none | 测点类型，analog,accumulator,status | |
| »» paramUnit | string¦null | false | none | 测点单位 | |
| »» remark | string¦null | false | none | 备注 | |
| »» id | integer | true | none | 设备绑定关系id | |
| »» ztGuid | string | true | none | 组态id | |
| »» dataType | string¦null | false | none | 数据类型，无符号16位，有符号16位等 | |
| »» acquisitionFormula | string¦null | false | none | 读取数据的处理公式 | |
| »» writeFormula | string¦null | false | none | 写入数据的处理公式 | |
| »» writeUp | number¦null | false | none | 上限 | |
| »» writeLow | number¦null | false | none | 下限 | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
枚举值
| 属性 | 值 |
|---|---|
| readWriteType | analog |
| readWriteType | accumulator |
| readWriteType | status |
GET 获取组态已绑定设备的所有遥调测点(树结构)
GET /api/zutai/device/getBindRemoteDataTree
deviceImei-->deviceMac
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| ztGuid | query | string | 是 | 组态guid |
| paramName | query | string | 否 | 测点名称，用于模糊查询测点名称 |
返回示例
200 Response
{
"total": 0,
"rows": [
{
"deviceMac": "string",
"deviceName": "string",
"disabled": "true",
"nodeKey": "string",
"children": [
{
"nodeKey": "string",
"deviceMac": 0,
"paramField": "string",
"paramName": "string",
"paramValue": "string",
"paramUnit": "string",
"ztGuid": "string",
"id": 0,
"remark": "string",
"readWriteType": "anolog",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
]
}
],
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» disabled | boolean | true | none | 固定值true | |
| »» nodeKey | string | true | none | 用于nodeKey，值为deviceMac | |
| »» children | [object] | false | none | 测点列表 | |
| »»» nodeKey | string | true | none | 用作nodeKey,值为{deviceMac}_{deviceField},如2_analog_2 | |
| »»» deviceMac | integer | true | none | 设备标识符 | |
| »»» paramField | string | true | none | 测点标识 | |
| »»» paramName | string | true | none | 测点名称 | |
| »»» paramValue | string | true | none | 测点值，此接口可不返回 | |
| »»» paramUnit | string¦null | false | none | 测点单位 | |
| »»» ztGuid | string | true | none | 组态id | |
| »»» id | integer | true | none | 设备绑定关系id | |
| »»» remark | string¦null | false | none | 备注 | |
| »»» readWriteType | string | true | none | 测点类型，analog,accumulator,status | |
| »»» dataType | string¦null | false | none | 数据类型，无符号16位，有符号16位等 | |
| »»» acquisitionFormula | string¦null | false | none | 读取数据的处理公式 | |
| »»» writeFormula | string¦null | false | none | 写入数据的处理公式 | |
| »»» writeUp | number¦null | false | none | 上限 | |
| »»» writeLow | number¦null | false | none | 下限 | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
枚举值
| 属性 | 值 |
|---|---|
| readWriteType | anolog |
| readWriteType | accumulator |
| readWriteType | status |
GET 获取组态已绑定设备的所有档位测点
GET /api/zutai/device/getBindGearDataList
deviceImei-->deviceMac
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| pageNum | query | integer | 是 | 查询页，默认值1 |
| pageSize | query | integer | 否 | 页容量，默认值999 |
| orderByColumn | query | string | 否 | 排序列，根据此列进行升降序排序 |
| isAsc | query | string | 否 | 排序方式，asc/desc |
| ztGuid | query | string | 是 | 组态guid |
| paramName | query | string | 否 | 测点名称，用于模糊查询测点名称 |
返回示例
200 Response
{
"total": 0,
"rows": [
{
"deviceMac": 0,
"deviceName": "string",
"paramName": "string",
"paramValue": "string",
"paramField": "string",
"readWriteType": "analog",
"paramUnit": "string",
"remark": "string",
"id": 0,
"ztGuid": "string",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
],
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» deviceMac | integer | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» paramName | string | true | none | 测点名称 | |
| »» paramValue | any | false | none | 测点值，此接口可不返回 |
oneOf
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | string | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | integer | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | boolean | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | array | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | object | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | number | false | none | none |
continued
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »» paramField | string | true | none | 测点标识 | |
| »» readWriteType | string | true | none | 测点类型，analog,accumulator,status | |
| »» paramUnit | string¦null | false | none | 测点单位 | |
| »» remark | string¦null | false | none | 备注 | |
| »» id | integer | true | none | 设备绑定关系id | |
| »» ztGuid | string | true | none | 组态id | |
| »» dataType | string¦null | false | none | 数据类型，无符号16位，有符号16位等 | |
| »» acquisitionFormula | string¦null | false | none | 读取数据的处理公式 | |
| »» writeFormula | string¦null | false | none | 写入数据的处理公式 | |
| »» writeUp | number¦null | false | none | 上限 | |
| »» writeLow | number¦null | false | none | 下限 | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
枚举值
| 属性 | 值 |
|---|---|
| readWriteType | analog |
| readWriteType | accumulator |
| readWriteType | status |
GET 获取组态已绑定设备的所有档位测点(树结构)
GET /api/zutai/device/getBindGearDataTree
deviceImei-->deviceMac
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| ztGuid | query | string | 是 | 组态guid |
| paramName | query | string | 否 | 测点名称，用于模糊查询测点名称 |
返回示例
200 Response
{
"total": 0,
"rows": [
{
"deviceMac": "string",
"deviceName": "string",
"disabled": "true",
"nodeKey": "string",
"children": [
{
"nodeKey": "string",
"deviceMac": 0,
"paramField": "string",
"paramName": "string",
"paramValue": "string",
"paramUnit": "string",
"ztGuid": "string",
"id": 0,
"remark": "string",
"readWriteType": "anolog",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
]
}
],
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» disabled | boolean | true | none | 固定值true | |
| »» nodeKey | string | true | none | 用于nodeKey，值为deviceMac | |
| »» children | [object] | false | none | 测点列表 | |
| »»» nodeKey | string | true | none | 用作nodeKey,值为{deviceMac}_{deviceField},如2_analog_2 | |
| »»» deviceMac | integer | true | none | 设备标识符 | |
| »»» paramField | string | true | none | 测点标识 | |
| »»» paramName | string | true | none | 测点名称 | |
| »»» paramValue | string | true | none | 测点值，此接口可不返回 | |
| »»» paramUnit | string¦null | false | none | 测点单位 | |
| »»» ztGuid | string | true | none | 组态id | |
| »»» id | integer | true | none | 设备绑定关系id | |
| »»» remark | string¦null | false | none | 备注 | |
| »»» readWriteType | string | true | none | 测点类型，analog,accumulator,status | |
| »»» dataType | string¦null | false | none | 数据类型，无符号16位，有符号16位等 | |
| »»» acquisitionFormula | string¦null | false | none | 读取数据的处理公式 | |
| »»» writeFormula | string¦null | false | none | 写入数据的处理公式 | |
| »»» writeUp | number¦null | false | none | 上限 | |
| »»» writeLow | number¦null | false | none | 下限 | |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
枚举值
| 属性 | 值 |
|---|---|
| readWriteType | anolog |
| readWriteType | accumulator |
| readWriteType | status |
其他
POST 图片上传
POST /api/zutai/common/upload
Body 请求参数
file: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » file | body | string(binary) | 否 | none |
返回示例
200 Response
{
"msg": "操作成功",
"fileName": "/profile/upload/2024/10/15/`%_8CJ6GVFQ~45QD_JBAL(B_20241015192713A061.png",
"code": 200,
"newFileName": "`%_8CJ6GVFQ~45QD_JBAL(B_20241015192713A061.png",
"url": "http://iot.yanfankeji.com/profile/upload/2024/10/15/`%_8CJ6GVFQ~45QD_JBAL(B_20241015192713A061.png",
"originalFilename": "`%_8CJ6GVFQ~45QD_JBAL(B.png"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » msg | string | true | none | none | |
| » fileName | string | true | none | none | |
| » code | integer | true | none | none | |
| » newFileName | string | true | none | none | |
| » url | string | true | none | none | |
| » originalFilename | string | true | none | none |
GET 获取省市区
GET /api/zutai/common/getArea
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| lvl | query | integer | 是 | 等级，1省2市3区 |
| provinceZh | query | string | 否 | 省（仅lvl==2时使用） |
| leaderZh | query | string | 否 | 市(仅lvl==3时使用) |
返回示例
200 Response
{
"msg": "string",
"code": 0,
"data": [
{
"id": 0,
"cityEn": "string",
"cityZh": "string",
"provinceEn": "string",
"provinceZh": "string",
"countryEn": "string",
"countryZh": "string",
"leaderEn": "string",
"leaderZh": "string",
"lat": 0,
"lon": 0,
"lvl": 0
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » msg | string | true | none | none | |
| » code | integer | true | none | none | |
| » data | [object] | true | none | none | |
| »» id | integer | true | none | 地区编码 | |
| »» cityEn | string | true | none | none | |
| »» cityZh | string | true | none | 市 | |
| »» provinceEn | string | true | none | none | |
| »» provinceZh | string | true | none | 省份 | |
| »» countryEn | string | true | none | none | |
| »» countryZh | string | true | none | 国家 | |
| »» leaderEn | string | true | none | none | |
| »» leaderZh | string | true | none | 区 | |
| »» lat | integer | true | none | 经度 | |
| »» lon | integer | true | none | 纬度 | |
| »» lvl | integer | true | none | none |
GET 发送http请求
GET /api/zutai/echart/sendHttpRequest
发送http请求，将结果返回
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| contentType | query | string | 否 | http请求content-type |
| data | query | string | 否 | 请求体，json格式 |
| headers | query | array[string] | 否 | 请求头数组，元素结构是{key:参数名,value:参数值} |
| method | query | string | 否 | 请求类型，get、post |
| params | query | array[string] | 否 | 请求参数，{key:参数名,value:参数值} |
| url | query | string | 否 | 请求url |
返回示例
200 Response
{
"code": 200,
"msg": "请求成功",
"data": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none | |
| » data | string | true | none | 请求的返回值整个塞进去 |
数据
GET 获取初始化数据
GET /api/zutai/data/getInitData
返回值的data是一个包含所有设备所有测点的实时数据，array中每个Object是一个设备得数据，至少包含设备标识设备，其他的键值对为测点数据，其中key为field
Imei-->deviceMac
组态数据为：{
"WebTopoGuid": "e7c095c6-bece-019e-7bd5-b7a2275cbf27",
"components": [
{
"action": [
],
"componentShow": [
"参数绑定",
"组件颜色",
"水流"
],
"dataAction": {
"direction": "",
"direction01": "",
"paramJudge": "",
"paramJudge01": "",
"paramJudgeData": 0,
"paramJudgeData01": 0
},
"dataBind": {
"identifiers": [
],
"imei": "",
"paramField": "",
"paramValue": "",
"queryParam": {
}
},
"icon": "views/zutai/components/topo/images/water.png",
"identifier": "e67f4a389f19409196507569d4ff4941",
"name": "CL-flow-bar-dynamic0",
"style": {
"anchorPointNum": 6,
"animations": "正向",
"backColor": "#6D7B92",
"borderColor": "#ccccccff",
"borderStyle": "solid",
"borderWidth": 0,
"direction": "水平",
"foreColor": "#F1A94B",
"lineHeight": 10,
"lineInterval": 20,
"lineType": "矩形",
"lineWidth": 15,
"position": {
"h": 50,
"w": 320,
"x": 1748.2,
"y": 885.1991666666667
},
"speed": "中",
"spotPoints": [
{
"x": 20,
"y": 20
},
{
"x": 70,
"y": 20
},
{
"x": 120,
"y": 20
},
{
"x": 170,
"y": 20
},
{
"x": 220,
"y": 20
},
{
"x": 270,
"y": 20
}
],
"temp": {
"position": {
"x": 700,
"y": 249
}
},
"transform": 0,
"transformType": "rotate(0deg)",
"visible": true,
"zIndex": 1
},
"type": "flow-bar-dynamic"
},
{
"action": [
],
"componentShow": [
"单击",
"组件颜色",
"动画"
],
"dataAction": {
"acquisitionFormula": "",
"imei": 170,
"paramField": "accumulator_6",
"paramJudge": "大于",
"paramJudgeData": 0,
"paramName": "累计交流充电电量",
"readWriteType": "accumulator",
"rotationSpeed": "中",
"translateList": [
],
"writeFormula": ""
},
"dataBind": {
"action": "",
"controllableComponent": false,
"controllableType": 1,
"djAction": false,
"driveName": "",
"hdAction": false,
"identifiers": [
],
"imei": "",
"paramField": "",
"paramName": "",
"paramValue": "",
"queryParam": {
},
"redirectUrl": "",
"ssAction": false,
"xyAction": false,
"xzAction": true
},
"icon": "views/zutai/components/topo/images/word.png",
"identifier": "a99099c96ac94aee913ccbb3894252ea",
"name": "CL-text1",
"style": {
"backColor": "transparent",
"borderColor": "#ccccccff",
"borderStyle": "solid",
"borderWidth": 0,
"fontFamily": "Arial",
"fontSize": 14,
"fontWeight": 100,
"foreColor": "#000",
"position": {
"h": 30,
"w": 100,
"x": 742.6783333333333,
"y": 437.5335416666667
},
"temp": {
"position": {
"x": 742.6783333333333,
"y": 437.5335416666667
}
},
"text": "Test",
"textAlign": "center",
"transform": 0,
"transformType": "rotate(0deg)",
"visible": true,
"zIndex": 1
},
"type": "text"
},
{
"action": [
],
"componentShow": [
"参数绑定",
"单击",
"组件颜色",
"动画",
"状态字段"
],
"dataAction": {
"imei": 170,
"paramField": "accumulator_23",
"paramJudge": "大于",
"paramJudgeData": 0,
"paramName": "累计交流充电电量",
"rotationSpeed": "中",
"translateList": [
]
},
"dataBind": {
"acquisitionFormula": "",
"action": "",
"controllableComponent": false,
"controllableType": 1,
"dataType": "",
"djAction": false,
"hdAction": false,
"identifiers": [
],
"imei": 170,
"paramField": "accumulator_23",
"paramName": "累计交流充电电量",
"paramUnit": "",
"paramValue": "",
"queryParam": {
},
"readWriteType": "accumulator",
"redirectUrl": "",
"ssAction": true,
"stateTextList": [
],
"writeFormula": "",
"xyAction": false,
"xzAction": false
},
"icon": "views/zutai/components/topo/images/number.png",
"identifier": "47e8d7e051de4fca96e1a8a2a41baa3f",
"name": "CL-text2",
"style": {
"backColor": "#fff",
"borderColor": "#ccccccff",
"borderStyle": "solid",
"borderWidth": 0,
"fontFamily": "Arial",
"fontSize": 14,
"fontWeight": 100,
"foreColor": "#000",
"position": {
"h": 50,
"w": 50,
"x": 539,
"y": 336
},
"text": "0",
"textAlign": "center",
"transform": 0,
"transformType": "rotate(0deg)",
"visible": true,
"zIndex": 1
},
"type": "text"
},
{
"action": [
],
"componentShow": [
"组件颜色",
"组件填充",
"参数绑定"
],
"dataBind": {
"biz": "",
"identifiers": [
],
"queryParam": {
},
"sn": "",
"stateList": [
],
"title": ""
},
"icon": "views/zutai/components/topo/images/line-arrow.png",
"identifier": "b0b0b92c582342cf842679c7078bf896",
"name": "CL-line-arrow3",
"style": {
"backColor": "rgba(0,0,0,0)",
"borderColor": "#ccccccff",
"borderStyle": "solid",
"borderWidth": 0,
"foreColor": "rgba(128,128,128,1)",
"lineWidth": 2,
"points": [
{
"x": 20,
"y": 10
},
{
"startX": 615,
"startY": 478,
"temp": {
"x": 100,
"y": 10
},
"x": 132,
"y": 153
},
{
"startX": 622,
"startY": 547,
"temp": {
"x": 107,
"y": 115
},
"x": 248,
"y": 221
},
{
"startX": 745,
"startY": 480,
"temp": {
"x": 300,
"y": 10
},
"x": 354,
"y": 175
},
{
"startX": 805,
"startY": 477,
"temp": {
"x": 400,
"y": 10
},
"x": 486,
"y": 139
},
{
"x": 500,
"y": 10
}
],
"position": {
"h": 300,
"w": 600,
"x": 288,
"y": 481
},
"temp": {
"position": {
"x": 288,
"y": 481
}
},
"transform": 0,
"transformType": "rotate(0deg)",
"visible": true,
"zIndex": 1
},
"type": "line-arrow"
},
{
"action": [
],
"componentShow": [
"状态开关",
"参数绑定",
"单击",
"组件颜色",
"设备状态",
"滤镜渲染"
],
"dataAction": {
"actualValue": "",
"paramJudge": "",
"paramJudge01": "",
"paramJudgeData": "",
"paramJudgeData01": ""
},
"dataBind": {
"action": "",
"activeName": "变量状态",
"controValue": "",
"controllableComponent": false,
"controllableType": 1,
"djAction": false,
"driveName": "",
"hdAction": false,
"identifiers": [
],
"imei": "",
"openImageUrl": "",
"paramField": "",
"paramName": "",
"paramValue": "",
"queryParam": {
},
"redirectUrl": "",
"shutImageUrl": "",
"ssAction": false,
"stateList": [
],
"warnImageUrl": "",
"xyAction": false,
"xzAction": false
},
"icon": "views/zutai/components/topo/images/switch.png",
"identifier": "84acfa3fcbdc42f6917527e9dde85a50",
"name": "CL-imageSwitch4",
"style": {
"borderColor": "#ccccccff",
"borderStyle": "solid",
"borderWidth": 0,
"position": {
"h": 50,
"w": 50,
"x": 544,
"y": 277
},
"temp": {
"position": {
"x": 544,
"y": 277
}
},
"transform": 0,
"transformType": "rotate(0deg)",
"url": "/dev-api/uploads/upload/841bc04e-4f09-49d1-8a82-3ffd50d33d28_b1.svg",
"visible": true,
"zIndex": 1
},
"type": "imageSwitch"
},
{
"action": [
],
"componentShow": [
"状态开关",
"参数绑定",
"单击",
"组件颜色",
"设备状态",
"滤镜渲染"
],
"dataAction": {
"actualValue": "",
"paramJudge": "",
"paramJudge01": "",
"paramJudgeData": "",
"paramJudgeData01": ""
},
"dataBind": {
"action": "",
"activeName": "变量状态",
"controValue": "",
"controllableComponent": false,
"controllableType": 1,
"djAction": false,
"driveName": "",
"hdAction": false,
"identifiers": [
],
"imei": "",
"openImageUrl": "",
"paramField": "",
"paramName": "",
"paramValue": "",
"queryParam": {
},
"redirectUrl": "",
"shutImageUrl": "",
"ssAction": false,
"stateList": [
],
"warnImageUrl": "",
"xyAction": false,
"xzAction": false
},
"icon": "views/zutai/components/topo/images/switch.png",
"identifier": "52c189a9e6eb4e04ba9e7a781d1b3eb8",
"name": "CL-imageSwitch5",
"style": {
"borderColor": "#ccccccff",
"borderStyle": "solid",
"borderWidth": 0,
"position": {
"h": 50,
"w": 50,
"x": 205.96875,
"y": 462.5
},
"transform": 0,
"transformType": "rotate(0deg)",
"url": "",
"visible": true,
"zIndex": 1
},
"type": "imageSwitch"
},
{
"action": [
],
"componentShow": [
"状态开关",
"参数绑定",
"单击",
"组件颜色",
"设备状态",
"滤镜渲染"
],
"dataAction": {
"acquisitionFormula": "",
"actualValue": "",
"imei": 171,
"paramField": "accumulator_23",
"paramJudge": "",
"paramJudge01": "",
"paramJudgeData": "",
"paramJudgeData01": "",
"paramName": "累计交流充电电量",
"readWriteType": "accumulator",
"writeFormula": ""
},
"dataBind": {
"acquisitionFormula": "",
"action": "",
"activeName": "变量状态",
"controValue": "",
"controllableComponent": false,
"controllableType": 1,
"dataType": "",
"djAction": false,
"hdAction": false,
"identifiers": [
],
"imei": 170,
"openImageUrl": "",
"paramField": "accumulator_173",
"paramName": "累计交流充电电量",
"paramValue": "",
"queryParam": {
},
"readWriteType": "accumulator",
"redirectUrl": "",
"shutImageUrl": "",
"ssAction": false,
"stateList": [
{
"id": 1,
"imageUrl": "/dev-api/uploads/upload/af99f13d-a9a6-43f0-a496-2901f5210e8e_b2.svg",
"paramCondition": "大于",
"paramData": 0
},
{
"id": 2,
"imageUrl": "/dev-api/uploads/upload/841bc04e-4f09-49d1-8a82-3ffd50d33d28_b1.svg",
"paramCondition": "小于等于",
"paramData": 0
}
],
"warnImageUrl": "",
"writeFormula": "",
"xyAction": false,
"xzAction": false
},
"icon": "views/zutai/components/topo/images/switch.png",
"identifier": "17a230717d36411ebfb708716ef212e4",
"name": "CL-imageSwitch6",
"style": {
"borderColor": "#ccccccff",
"borderStyle": "solid",
"borderWidth": 0,
"position": {
"h": 50,
"w": 50,
"x": 264,
"y": 271
},
"temp": {
"position": {
"x": 264,
"y": 271
}
},
"transform": 0,
"transformType": "rotate(0deg)",
"url": "",
"visible": true,
"zIndex": 1
},
"type": "imageSwitch"
},
{
"action": [
],
"componentShow": [
"组件颜色",
"变量日志",
"横轴间隔"
],
"dataBind": {
"biz": "",
"identifiers": [
],
"lData": [
],
"queryParam": {
},
"sn": "",
"timeInterval": 30,
"timeNum": 6,
"title": "",
"xData": [
"11:30",
"12:00",
"12:30",
"13:00",
"13:30"
],
"xInterval": 0,
"yData": [
{
"data": [
20,
30,
42,
35,
65,
15
],
"name": "温度"
},
{
"data": [
80,
90,
95,
92,
96,
93
],
"name": "湿度"
},
{
"data": [
100,
102,
130,
150,
160,
96
],
"name": "压强"
}
]
},
"icon": "views/zutai/components/topo/images/chart-line.png",
"identifier": "dd90acf63aa0465ebb8d1b28e097b3e4",
"name": "CL-chart-line7",
"qIcon": "show_chart",
"style": {
"backColor": "rgba(255,255,255,1)",
"borderColor": "#ccccccff",
"borderStyle": "solid",
"borderWidth": 0,
"foreColor": "rgba(0,0,0,1)",
"position": {
"h": 250,
"w": 500,
"x": 1619.7304166666668,
"y": 1541.1949999999997
},
"temp": {
"position": {
"x": 581.7212499999999,
"y": 656.0483333333333
}
},
"transform": 0,
"transformType": "rotate(0deg)",
"visible": true,
"zIndex": 1
},
"type": "chart-line"
}
],
"layer": {
"backColor": "",
"backgroundImage": "",
"height": 600,
"second": 30,
"width": 960,
"widthHeightRatio": ""
},
"name": "--"
}
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| ztGuid | query | string | 是 | 组态guid |
返回示例
200 Response
{
"code": 200,
"msg": "success",
"data": [
{
"deviceMac": "string"
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 |
GET 获取测点真实数据
GET /api/zutai/data/getFieldsData
deviceMac和paramFiled传入多个时，一一对应
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMacs | query | string | 否 | 设备标识符，多个设备用;分割 |
| paramFields | query | string | 否 | 测点标识符，多个测点用;分割 |
返回示例
200 Response
{
"code": 200,
"msg": "查询成功",
"total": 0,
"rows": [
{
"deviceMac": "string",
"deviceName": "string",
"paramName": "string",
"paramValue": "string",
"paramUnit": "string"
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none | |
| » total | integer | true | none | 总数 | none |
| » rows | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | none |
| »» deviceName | string | true | none | 设备名称 | none |
| »» paramName | string | true | none | 测点名称 | none |
| »» paramValue | string | true | none | 测点值 | none |
| »» paramUnit | string | true | none | 测点单位 | none |
GET 获取测点最新数据
GET /api/zutai/data/getLatestData
参数传入的Mac,Field,Name,顺序都是一致的、一一对应的
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMacs | query | string | 是 | 设备标识符，多个中间用;隔开 |
| paramFields | query | string | 是 | 测点标识符，多个中间用;隔开 |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功",
"rows": [
{
"paramName": "string",
"paramValue": 0
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none | |
| » rows | [object] | true | none | ？ | |
| »» paramName | string | true | none | 测点名称 | |
| »» paramValue | number | true | none | 测点值 |
POST 下发指令
POST /api/zutai/data/orderSend
遥控操作，编号为deviceMac的设备的paramField测点的值置为paramValue
Body 请求参数
paramField: ""
deviceMac: ""
paramName: ""
paramValue: ""
dataType: ""
orderPassword: ""
controlType: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » paramField | body | string | 是 | 测点标识符 |
| » deviceMac | body | string | 是 | 设备标识符 |
| » paramName | body | string | 是 | 测点名称 |
| » paramValue | body | string | 是 | 操作值 |
| » dataType | body | string | 否 | 数据的类型 |
| » orderPassword | body | string | 否 | 遥控密码，base64加密 |
| » controlType | body | string | 否 | 控制类型，dz定值、yk遥控 |
返回示例
200 Response
{
"code": 200,
"msg": "操作成功"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
GET 获取变量的曲线数据
GET /api/zutai/data/getLinesData
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMacs | query | string | 否 | 设备id，多个中间用;隔开 |
| startTime | query | string | 否 | none |
| endTime | query | string | 否 | none |
| type | query | string | 否 | 曲线类型：day日、month月、year年 |
| paramFields | query | string | 否 | 测点filed，多个中间用;隔开 |
| paramNames | query | string | 否 | 测点名称，多个中间用;隔开 |
返回示例
200 Response
{
"msg": "操作成功",
"code": 200,
"data": {
"timeList": [
"2024-11-01 08:11:42",
"2024-11-01 08:21:42",
"2024-11-01 08:31:42",
"2024-11-01 08:41:42",
"2024-11-01 08:51:42",
"2024-11-01 09:01:42",
"2024-11-01 09:11:42",
"2024-11-01 09:21:42",
"2024-11-01 09:31:42",
"2024-11-01 09:41:42",
"2024-11-01 09:51:42",
"2024-11-01 10:01:42",
"2024-11-01 10:11:42"
],
"list": [
{
"paramName": "null",
"data": []
},
{
"paramName": "空气温度",
"data": []
}
]
}
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | object | true | none | none | |
| »» timeList | string | true | none | 时间列表，图表横坐标数据 | |
| »» list | [object] | true | none | none | |
| »»» paramName | string | true | none | 测点名称（data为[]时也不可省略） | |
| »»» data | [number] | true | none | none |
遥控密码
POST 密码验证
POST /api/zutai/orderPassword/verify
Body 请求参数
orderPassword: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » orderPassword | body | string | 是 | 遥控密码，base64加密，后端需进行解密 |
返回示例
200 Response
{
"code": 0,
"msg": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
POST 修改密码
POST /api/zutai/orderPassword/update
Body 请求参数
orderPassword: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » orderPassword | body | string | 否 | 控制密码，base64加密 |
返回示例
200 Response
{
"code": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | string | true | none | none |
授权
POST 登录
POST /api/zutai/login
Body 请求参数
username: ""
password: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » username | body | string | 否 | none |
| » password | body | string | 否 | none |
返回示例
200 Response
{
"code": 200,
"message": "string",
"data": {
"user_id": 1,
"user_name": "string",
"permission": [
"string"
],
"param": {
"station_id": 100
}
}
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | object | true | none | none | |
| »» token | string | true | none | none |
GET 获取用户信息
GET /api/zutai/info
Body 请求参数
{}请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| token | query | string | 否 | none |
| body | body | object | 否 | none |
返回示例
200 Response
{
"code": 200,
"message": "string",
"data": {
"user_id": 1,
"user_name": "string",
"permission": [
"string"
]
}
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | number | true | none | none | |
| » message | string | true | none | none | |
| » data | object | true | none | none | |
| »» user_id | integer | true | none | none | |
| »» user_name | string | true | none | none | |
| »» permission | [string] | true | none | none |
POST 登出
POST /api/zutai/logout
返回示例
200 Response
{
"code": 0,
"message": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none |
第三方实现/用户
POST 授权登录
POST /oauth/login
OAuth2.0密码模式，返回结果需要按照OAuth2.0规范
Body 请求参数
client_id: ""
client_secret: ""
username: ""
password: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » client_id | body | string | 否 | 客户端id |
| » client_secret | body | string | 否 | 客户端secret |
| » username | body | string | 否 | 用户名 |
| » password | body | string | 否 | 密码 |
返回示例
200 Response
{
"code": 0,
"message": "string",
"access_token": "string",
"token_type": "string",
"refresh_token": "string",
"expiry": "string",
"expires_in": 0,
"expiry_delta": "string",
"raw": {}
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » access_token | string | true | none | 请求token | |
| » token_type | string | true | none | token类型，如Bearer | |
| » refresh_token | string | false | none | none | |
| » expiry | string | true | none | none | |
| » expires_in | integer | false | none | none | |
| » expiry_delta | string | false | none | none | |
| » raw | object | false | none | 携带的其他参数 |
GET 用户信息
GET /auth/info
组态操作权限：zutai_create(创建组态)、zutai_update(修改组态基础配置)、zutai_edit(编辑/配置组态)、zutai_delete(删除组态)、zutai_view(查看组态)、order_password(修改控制密码)
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| token | query | string | 是 | none |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": {
"user_id": "string",
"user_name": "string",
"permissions": [
"string"
]
}
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | object | true | none | none | |
| »» user_id | string | true | none | 用户id | |
| »» user_name | string | true | none | 用户名称 | |
| »» permissions | [string] | true | none | 权限列表 |
第三方实现/设备
GET 获取用户可用设备列表
GET /zutai/equip/list
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| pageNum | query | integer | 是 | 当前页 |
| pageSize | query | integer | 是 | 页容量 |
| deviceName | query | string | 否 | 设备名称（模糊查询） |
| deviceMac | query | string | 否 | 设备标识符 |
| station_id | query | string | 否 | none |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": [
{
"deviceMac": "string",
"deviceName": "string",
"deviceType": "string",
"deviceModel": "string",
"deviceStatus": 0,
"remark": "string",
"logitude": "string",
"latitude": "string"
}
],
"total": 0
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» deviceType | string¦null | false | none | 设备类型 | |
| »» deviceModel | string¦null | false | none | 设备型号 | |
| »» deviceStatus | integer | true | none | 设备状态：0离线、1在线、2报警 | |
| »» remark | string¦null | false | none | 备注 | |
| »» logitude | string¦null | false | none | 经度 | |
| »» latitude | string¦null | false | none | 纬度 | |
| » total | integer | true | none | 总条数 |
GET 通过设备编号获取设备列表
GET /zutai/equip/listByMac
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMac | query | string | 是 | 设备标识符，多个用;隔开 |
| deviceName | query | string | 否 | 模糊查询关键字 |
返回示例
200 Response
{
"code": "string",
"message": "string",
"data": [
{
"deviceMac": "string",
"deviceName": "string",
"devicaStatus": 0,
"installationAddress": "string",
"longitude": "string",
"latitude": "string"
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | string | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» devicaStatus | integer | true | none | 设备状态：0离线、1在线、2报警 | |
| »» installationAddress | string¦null | false | none | 设备所在地 | |
| »» longitude | string¦null | false | none | 经度 | |
| »» latitude | string¦null | false | none | 纬度 |
第三方实现/测点
GET 获取设备测点
GET /zutai/param/list
通过设备标识符获取设备测点
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMac | query | string | 是 | 设备标识符，多个设备之间使用;隔开 |
| paramName | query | string | 否 | 模糊查询关键词 |
| readWriteType | query | string | 否 | 测点类型：analog、accumulator、status |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": [
{
"deviceMac": "string",
"deviceName": "string",
"list": [
{
"paramField": "string",
"paramName": "string",
"readWriteType": "string",
"paramUnit": "string",
"remark": "string",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
]
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» list | [object] | true | none | 测点列表 | |
| »»» paramField | string | true | none | 测点标识 | |
| »»» paramName | string | true | none | 测点名称 | |
| »»» readWriteType | string | true | none | 测点类型：analog、accumulator、status | |
| »»» paramUnit | string¦null | false | none | 测点单位 | |
| »»» remark | string¦null | false | none | 备注 | |
| »»» dataType | string¦null | false | none | 数据类型 | |
| »»» acquisitionFormula | string¦null | false | none | 读取数据公式 | |
| »»» writeFormula | string¦null | false | none | 写入数据公式 | |
| »»» writeUp | number¦null | false | none | 上限 | |
| »»» writeLow | number¦null | false | none | 下限 |
GET 获取设备可控测点
GET /zutai/param/control
通过设备标识符获取设备可控测点
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMac | query | string | 是 | 设备标识符，多个设备之间使用;隔开 |
| paramName | query | string | 否 | 模糊查询关键词 |
| controlType | query | integer | 是 | 控制类型：1遥信，2遥测 |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": [
{
"deviceMac": "string",
"deviceName": "string",
"list": [
{
"paramField": "string",
"paramName": "string",
"readWriteType": "string",
"paramUnit": "string",
"remark": "string",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
]
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» list | [object] | true | none | 测点列表 | |
| »»» paramField | string | true | none | 测点标识 | |
| »»» paramName | string | true | none | 测点名称 | |
| »»» readWriteType | string | true | none | 测点类型：analog、accumulator、status | |
| »»» paramUnit | string¦null | false | none | 测点单位 | |
| »»» remark | string¦null | false | none | 备注 | |
| »»» dataType | string¦null | false | none | 数据类型 | |
| »»» acquisitionFormula | string¦null | false | none | 读取数据公式 | |
| »»» writeFormula | string¦null | false | none | 写入数据公式 | |
| »»» writeUp | number¦null | false | none | 上限 | |
| »»» writeLow | number¦null | false | none | 下限 |
GET 设备遥调测点
GET /zutai/param/remote
通过设备标识符获取设备遥调测点
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMac | query | string | 是 | 设备标识符，多个设备之间使用;隔开 |
| paramName | query | string | 否 | 模糊查询关键词 |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": [
{
"deviceMac": "string",
"deviceName": "string",
"list": [
{
"paramField": "string",
"paramName": "string",
"readWriteType": "string",
"paramUnit": "string",
"remark": "string",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
]
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» list | [object] | true | none | 测点列表 | |
| »»» paramField | string | true | none | 测点标识 | |
| »»» paramName | string | true | none | 测点名称 | |
| »»» readWriteType | string | true | none | 测点类型：analog、accumulator、status | |
| »»» paramUnit | string¦null | false | none | 测点单位 | |
| »»» remark | string¦null | false | none | 备注 | |
| »»» dataType | string¦null | false | none | 数据类型 | |
| »»» acquisitionFormula | string¦null | false | none | 读取数据公式 | |
| »»» writeFormula | string¦null | false | none | 写入数据公式 | |
| »»» writeUp | number¦null | false | none | 上限 | |
| »»» writeLow | number¦null | false | none | 下限 |
GET 设备档位测点
GET /zutai/param/gear
通过设备标识符获取设备档位测点
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMac | query | string | 是 | 设备标识符，多个设备之间使用;隔开 |
| paramName | query | string | 否 | 模糊查询关键词 |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": [
{
"deviceMac": "string",
"deviceName": "string",
"list": [
{
"paramField": "string",
"paramName": "string",
"readWriteType": "string",
"paramUnit": "string",
"remark": "string",
"dataType": "string",
"acquisitionFormula": "string",
"writeFormula": "string",
"writeUp": 0,
"writeLow": 0
}
]
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» list | [object] | true | none | 测点列表 | |
| »»» paramField | string | true | none | 测点标识 | |
| »»» paramName | string | true | none | 测点名称 | |
| »»» readWriteType | string | true | none | 测点类型：analog、accumulator、status | |
| »»» paramUnit | string¦null | false | none | 测点单位 | |
| »»» remark | string¦null | false | none | 备注 | |
| »»» dataType | string¦null | false | none | 数据类型 | |
| »»» acquisitionFormula | string¦null | false | none | 读取数据公式 | |
| »»» writeFormula | string¦null | false | none | 写入数据公式 | |
| »»» writeUp | number¦null | false | none | 上限 | |
| »»» writeLow | number¦null | false | none | 下限 |
GET 获取测点信息及数据
GET /zutai/param/data
一组mac和field标识唯一测点，通过mac-filed为组的唯一标识符获取测点
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMacs | query | string | 是 | 设备标识符，多个设备之间使用;隔开，与fileds一一对应 |
| paramFileds | query | string | 是 | 测点标识符，多个测点之间使用;隔开，与macs一一对应 |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": [
{
"deviceMac": "string",
"deviceName": "string",
"paramFiled": "string",
"paramName": "string",
"paramValue": "string"
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» deviceName | string | true | none | 设备名称 | |
| »» paramFiled | string | true | none | 测点标识符 | |
| »» paramName | string | true | none | 测点名称 | |
| »» paramValue | any | true | none | 测点值 |
oneOf
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | string | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | integer | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | boolean | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | array | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | object | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | number | false | none | none |
第三方实现/数据
GET 获取测点实时数据
GET /zutai/data/last
1.不必获取测点信息，直接进行数据查询；2.和query顺序保持一致
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMacs | query | string | 是 | 设备标识符，多个设备之间使用;隔开，与fileds一一对应 |
| paramFileds | query | string | 是 | 测点标识符，多个测点之间使用;隔开，与macs一一对应 |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": [
{
"deviceMac": "string",
"paramFiled": "string",
"paramValue": "string"
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» paramFiled | string | true | none | 测点标识符 | |
| »» paramValue | any | true | none | 测点值 |
oneOf
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | string | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | integer | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | boolean | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | array | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | object | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | number | false | none | none |
GET 获取初始化数据
GET /zutai/data
1.用于获取大量测点的实时数据，初始化时使用，list即为从组态配置中读取的使用数据
2.list结构(json格式)：
{"deviceMac":int,"paramFields":string[]}[]
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| list | query | string | 否 | json数据，结构为{"deviceMac":int,"paramFields":string[]}[] |
返回示例
200 Response
{
"code": 200,
"message": "查询成功",
"data": [
{
"deviceMac": 6,
"analog_1": 100,
"analog_2": 100
},
{
"deviceMac": 7,
"analog_1": 100,
"analog_2": 100,
"status_1": 0
}
]
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | [object] | true | none | none | |
| »» deviceMac | string | true | none | 设备标识符 | |
| »» $ | any | true | none | 测点值1 |
oneOf
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | string | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | integer | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | boolean | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | array | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | object | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | number | false | none | none |
continued
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »» $ | any | true | none | 测点值2 |
oneOf
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | string | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | integer | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | boolean | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | array | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | object | false | none | none |
xor
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »»» anonymous | number | false | none | none |
GET 变量曲线数据
GET /、zutai/data/lines
获取历史曲线
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| deviceMacs | query | string | 否 | 设备唯一标识符，多个之间;隔开 |
| paramFields | query | string | 否 | 测点编码，多个之间;隔开 |
| paramNames | query | string | 否 | 测点名称，多个之间;隔开 |
| type | query | string | 否 | 曲线类型：day，month，year |
| startTime | query | string | 否 | none |
| endTime | query | string | 否 | none |
返回示例
200 Response
{
"code": 0,
"message": "string",
"data": {
"timeList": [
"string"
],
"list": [
{
"paramName": "string",
"data": [
0
]
}
]
}
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none | |
| » data | object | true | none | none | |
| »» timeList | [string] | true | none | none | |
| »» list | [object] | true | none | none | |
| »»» paramName | string | true | none | none | |
| »»» data | [number] | true | none | none |
第三方实现/控制
POST 下发控制
POST /zutai/order/send
根据配置判断密码验证在组态后端或目标系统后端，若密码验证在目标系统则需要请求包含orderPassword参数，否则不需要携带
Body 请求参数
deviceMac: ""
paramField: ""
paramValue: ""
dataType: ""
orderPassword: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » deviceMac | body | string | 是 | 设备标识符 |
| » paramField | body | string | 是 | 测点标识符 |
| » paramValue | body | string | 是 | 操作值 |
| » dataType | body | string | 否 | 数据类型 |
| » orderPassword | body | string | 否 | 遥控密码，base64加密，根据配置判断密码验证在组态后端或目标系统后端，若密码验证在目标系统则需要请求包含orderPassword参数，否则不需要携带 |
返回示例
200 Response
{
"code": 0,
"message": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none |
第三方实现/控制密码
POST 验证密码
POST /zutai/orderPassword/verify
Body 请求参数
password: ""
user_id: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » password | body | string | 否 | base64加密 |
| » user_id | body | string | 否 | none |
返回示例
200 Response
{
"code": 0,
"message": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none |
POST 修改密码
POST /zutai/orderPassword/update
Body 请求参数
user_id: ""
password: ""请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| body | body | object | 否 | none |
| » user_id | body | string | 否 | none |
| » password | body | string | 否 | base64加密 |
返回示例
200 Response
{
"code": 0,
"message": "string"
}返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer | true | none | none | |
| » message | string | true | none | none |