iot.md 5.4 KB

通用参数说明

以下参数放在 url 后

字段 数据类型 说明
groupCode String 集团编码, 不可为空
projectId String 项目 id, 不可为空
appId String 应用 id, 不可为空

基础接口: 查询实时数据

接口说明

查询对象绑点信息点的实时数据

请求地址

POST: /rwd/iot/data/current

请求参数

[
    { "objectId": "Eqxxxxx", "infoCode": "tdb" },
    { "objectId": "Eqxxxxx", "infoCode": "co2" },
    { "objectId": "Eqxxxxx", "infoCode": "hcho" }
]

返回内容

{
    "result": "success",
    "data": [
        {
            "objectId": "Eqxxxxx",
            "infoCode": "tdb",
            "infoValue": "8000-123",
            "data": 25.6,
            "time": "20200512172435"
        },
        {
            "objectId": "Eqxxxxx",
            "infoCode": "tdb",
            "infoValue": "8000-123",
            "data": 25.6,
            "time": "20200512172435"
        },
        {
            "objectId": "Eqxxxxx",
            "infoCode": "tdb",
            "error": "错误信息:信息点不存在,表号功能号配置错误,断数等"
        }
    ]
}

返回内容说明

    infoValue: 信息点配置的内容即绑定的表号功能号
    time: 实时数据的采集时间
    data: 实时数据的值

基础接口: 查询历史数据/分精度数据

接口说明

查询对象绑点信息点的历史数据
1. 多点位个数最多支持50个
2. 分钟级数据,单点位支持最大7天数据查询,多点位支持最大1天数据查询;
3. 小时级数据,单点支持最大30天数据查询,多点位支持最大3天数据查询;
4. 日级数据,单点支持最大1年数据查询,多点位支持最大30天数据查询;

请求地址

POST: /rwd/iot/data/history

请求参数

{
    "startTime": "20200415120000",
    "endTime": "20200501120000",
    "period": "分精度类型,支持 1min、5min、15min、1h、1d",
    "params": [
        {
            "objectId": "对象id",
            "infoCode": "信息点编码",
        },
        {
            "objectId": "对象id",
            "infoCode": "信息点编码",
        }
    ]
}

参数说明


    startTime:
    period: 必填,间隔
    objectId: 必填,对象id
    infoCode: 必填,信息点ID

返回内容

{
    "result": "success",
    "data": [
        {
            "objectId": "对象id",
            "infoCode": "信息点编码",
            "data": [
                {
                    "time": "20200415120000"
                    "data": 25.6,
                },
                {
                    "time": "20200415120500"
                    "data": 25.6,
                }
            ]
        },
        {
            "objectId": "对象id",
            "infoCode": "信息点编码",
            "data": [
                {
                    "time": "20200415120000"
                    "data": 25.6,
                },
                {
                    "time": "20200415120500"
                    "data": 25.6,
                }
            ]
        }
    ]
}

返回内容说明

返回数据的time可能是不连续的

基础接口: 发送控制指令/设定动态参数

接口说明

该接口为异步方式

请求地址

POST: /rwd/iot/funcid/setting

请求参数

[
    { "objectId": "Eqxxxxx", "infoCode": "FanFreqSet", value: 24 },
    { "objectId": "Eqxxxxx", "infoCode": "InValveSwitchSet", value: "a" },
    { "objectId": "Eqxxxxx", "infoCode": "WaterInOutDetaTempSet", value: 10 }
]

请求参数说明

value要严格匹配信息点定义的数据类型

返回内容

{
    "result": "success",
    "data": [
        {
            "objectId": "Eqxxxxx",
            "infoCode": "FanFreqSet",
            "exeCode":"sfge131v4t2vs3423rbsb3"
        },
        {
            "objectId": "Eqxxxxx",
            "infoCode": "InValveSwitchSet",
            "exeCode":"sfge131v4t2vs3423rbsb3"
        },
        {
            "objectId": "Eqxxxxx",
            "infoCode": "InValveSwitchSet",
            "exeCode":"sfge131v4t2vs3423rbsb3"
        }
    ]
}

返回内容说明

    exeCode: 指令查询码,用于查询指令执行结果

基础接口: 查询指令执行结果

请求地址

POST: /iot/funcid/settingQuery

请求参数

[ "sfge131v4t2vs3423rbqb3", "e1ge131v4t2vs3423rbsb3", "eaqge131v4t2vs3423rger" ]

返回内容

{
    "result": "success",
    "data": [
        {
            "exeCode": "sfge131v4t2vs3423rbqb3",
            "exeResult": "timeout",
        },
        {
            "exeCode": "e1ge131v4t2vs3423rbsb3",
            "exeResult": "running",
        },
        {
            "exeCode": "eaqge131v4t2vs3423rger",
            "exeResult": "failed",
        }
    ]
}

控制指令执行结果说明(待定)


控制指令执行结果为一个字符串,其可能值有以下几种:
- finish:success,执行完成
- timeout,表示控制指令已下发但超过了合理响应时间(默认1minute,系统可配置)至今一直为得到反馈
- running,表示控制指令已下发在合理响应时间内还未得到反馈
- failed,指令未下发出去
- success-offline,指令已下发出去,并得到了反馈,'success-'后面的字符为反馈的信息