OneNET Studio 简介 产品介绍
功能介绍 资源模型 名词解释
快速入门
账户与登录 实名认证
设备接入与管理
设备接入流程 创建产品 开发产品物模型
什么是物模型？ 物模型管理 物模型通信协议
OneJSON
协议简介 设备属性/事件 设备服务 设备期望属性值 管理拓扑关系 子设备上下线 子设备数据交互 LwM2M拓展
数据解析
什么是数据解析？ 脚本开发 MQTT设备开发 LwM2M设备开发 最佳实践
创建设备 转移设备 文件管理 远程配置 标准协议接入
接入概述 接入安全认证 设备接入SDK MQTT协议接入
MQTT设备连接 通信主题 使用限制 最佳实践
CoAP协议接入
CoAP设备连接 使用限制
LwM2M协议接入
LwM2M协议规范 LwM2M-Studio概览 LwM2M设备创建 LwM2M设备开发
HTTP协议接入
HTTP接入使用说明 HTTP接入接口列表
直连设备API
设备属性上报 设备事件上报 批量数据上报 历史数据上报
代理设备API
设备属性上报 设备事件上报 批量数据上报 历史数据上报 子设备上线 子设备下线 添加子设备 删除子设备 获取拓扑关系
泛协议接入
服务概述 代理直连设备 代理网关设备 SDK开发指南 最佳实践-云云对接 最佳实践-代理直接设备 最佳实践-代理网关设备 相关限制 SDK历史版本文档
1.0.3 Version
SDK开发指南 最佳实践-代理直接设备
物模版库 生态接入认证
应用开发
应用开发流程 新建项目 添加设备 设备分组 场景联动 应用数据流转
规则引擎
服务概述 消息源格式 SQL说明 消息目的地
消息队列MQ HTTP推送
HTTP数据推送 消息队列MQ
应用API
使用说明 安全鉴权 错误码 SDK下载 设备管理类
设备创建 设备批量创建 设备编辑 设备删除 设备详情 设备转移 物模型系统功能点 物模型查询 设备工业标识注册
应用开发类
项目概况 项目集成产品列表 项目集成设备列表 项目添加设备 项目移除设备 分组创建 分组删除 分组编辑 分组详情 分组列表 分组设备添加 分组设备移除 设备详情 设备状态查询 设备状态记录查询 设备属性设置 设备属性获取 设备属性期望设置 设备属性期望查询 设备属性期望删除 设备操作日志查询 设备最新数据查询 设备属性记录查询 设备事件记录查询 设备服务调用 设备服务执行记录查询 设备文件上传 设备文件下载 设备文件删除 账户文件列表查询 账户文件存储空间查询 账户设备文件数量查询 场景联动规则创建 场景联动规则编辑 场景联动规则详情 场景联动规则列表 场景联动触发日志
LwM2M-IPSO类
即时命令API
设备资源列表获取 资源发现 资源订阅 读设备资源 写设备资源 命令下发
缓存命令API
读设备资源 写设备资源 命令下发
DTLS相关API
查看设备bs_psk 更新bs_psk 新增acc_psk 编辑acc_psk 查看设备acc_psk
应用长连接
服务概述 最佳实践
规则引擎（新）
服务概述 消息源格式 SQL说明
运维监控
设备调试 API调试 日志服务 告警中心 远程升级 设备防御
数据可视化 边缘计算 人工智能AI 位置定位
服务简介 产品定价 基站定位开发指南 基站位置查询API WiFi定位开发指南 WiFi位置查询API
语音通话
服务简介 产品定价 语音通知模板规范 API接口
API使用说明 错误码 语音通知 语音通知状态呼叫通知 点击拨号 点击拨号状态呼叫通知
工业互联网标识
服务简介 服务开通 前缀管理 数据模板 标识管理
权限管理
服务简介 主账户操作 协作账户操作
服务协议
公测服务协议 位置定位服务协议 语音通话服务协议 工业互联网标识服务协议
更新日志

设备属性/事件

1. 设备属性上报

2. 设备属性设置

3. 设备属性获取

4. 设备事件上报

5. 批量数据上报

6. 历史数据上报

1. 设备属性上报

上行(OneJSON）

  • 请求topic: $sys/{pid}/{device-name}/thing/property/post

OneJSON数据格式:

{
  "id": "123",
  "version": "1.0",
  "params": {
    "Power": {
      "value": "on",
      "time": 1524448722123
    },
    "WF": {
      "value": 23.6,
      "time": 1524448722123
    }
  }
}

表：请求参数描述

参数 类型 描述
id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
version String 物模型版本号，可选字段，不填默认为1.0
params JsonObject 请求参数，用户自定义，标准json格式。如以上示例中，设备上报了的两个属性Power和WF。具体属性信息，包含属性上报时间（time）和上报的属性值（value）。
time Long 属性值生成时间。该参数为可选字段，到豪秒级。根据您的业务场景决定消息中是否带时间戳。如果消息频繁，需根据时间戳判断消息顺序，建议消息中带有时间戳。
value Object 上报的属性值
  • 响应topic: $sys/{pid}/{device-name}/thing/property/post/reply

OneJSON数据格式:

{
  "id": "123",
  "code":200,
  "msg":"xxxx"
}

表:响应参数描述

参数 类型 描述
Id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
code Integer 结果状态码
msg String 错误信息

2. 设备属性设置

下行(OneJSON):

  • 请求topic: $sys/{pid}/{device-name}/thing/property/set

OneJSON数据格式：

{
  "id": "123",
  "version": "1.0",
  "params": {
    "temperature":"30.5"
  }
}

表：请求参数描述

参数 类型 描述
id String 消息id号，平台定义，String类型的数字，长度限制13
version String 物模型版本号，可选字段，不填默认为1.0
params JsonObject 属性设置参数。如以上示例中，设置属性：{"temperature":"30.5" }
  • 响应topic: $sys/{pid}/{device-name}/thing/property/set_reply

OneJSON数据格式：

{
    "id":"123",
    "code":200,
    "msg":"xxxx"
}

表:响应参数描述

参数 类型 描述
Id String 消息id号，平台定义，String类型的数字，长度限制不超过13位。
code Integer 结果状态码
msg String 错误信息

3. 设备属性获取

下行(OneJSON):

  • 请求topic: $sys/{pid}/{device-name}/thing/property/get

OneJSON数据格式：

{
    "id":"123",
    "version":"1.0",
    "params":[
        "temperature",
        "humidity"
    ]
}

表：请求参数描述

参数 类型 描述
id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
version String 物模型版本号，可选字段，不填默认为1.0
params JsonObject 获取属性最新值的标识符列表
  • 响应topic: $sys/{pid}/{device-name}/thing/property/get_reply

OneJSON数据格式：

{
    "id":"123",
    "code":200,
    "msg":"xxx",
    "data":{
        "temperature":39.5,
        "humidity":20
    }
}

表：响应参数描述

参数 类型 描述
id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
code Integer 结果状态码，用户自定义
msg String 错误信息
data JsonObject 获取属性最新值列表

4. 设备事件上报

上行(OneJSON)

  • 请求topic: $sys/{pid}/{device-name}/thing/event/post

OneJSON数据格式:

{
    "id":"123",
    "version":"1.0",
    "params":{
        "identifier1":{
            "value":{
                "Power":"on",
                "WF":"2"
            },
            "time":1524448722123
        },
        "identifier2":{
            "value":{
                "Power":"on",
                "WF":"2"
            },
            "time":1524448722123
        }
    }
}

表：请求参数描述

参数 类型 描述
id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
version String 物模型版本号，可选字段，不填默认为1.0
params JsonObject 上报事件的参数。
time Long 属性值生成时间。该参数为可选字段，到豪秒级。根据您的业务场景决定消息中是否带时间戳。如果消息频繁，需根据时间戳判断消息顺序，建议消息中带有时间戳。
value Object 具体的事件信息。如以上示例中{ "Power": "on", "WF": "2"}
  • 响应topic: $sys/{pid}/{device-name}/thing/event/post/reply

OneJSON数据格式:

{
  "id": "123",
  "code":200,
  "msg":"xxxx"
}

表:响应参数描述

参数 类型 描述
Id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
code Integer 结果状态码
msg String 错误信息

5. 批量数据上报

上行(OneJSON)

  • 请求topic: $sys/{pid}/{device-name}/thing/pack/post

    说明： 每次批量上送不超过10个子设备，每个设备上送数据点数量不超过100个

OneJSON数据格式:

{
    "id":"123",
    "version":"1.0",
    "params":[
        {
            "identity":{
                "productID":"",
                "deviceName":""
            },
            "properties":{
                "Power":{
                    "value":"on",
                    "time":1524448722000
                },
                "WF":{
                    "value":"3",
                    "time":1524448723000
                }
            },
            "events":
                {
                    "alarmEvent1":{
                        "value":{
                            "Power":"on",
                            "WF":"2"
                        },
                        "time":1524448722000
                    },
                    "alarmEvent2":{
                        "value":{
                            "Power":"on",
                            "WF":"2"
                        },
                        "time":1524448722000
                    }
                }
        },
        {
            "identity":{
                "productID":"",
                "deviceName":""
            },
            "properties":{
                "Power":{
                    "value":"on",
                    "time":1524448722000
                },
                "WF":{
                    "value":"3",
                    "time":1524448723000
                }
            },
            "events":
                {
                    "alarmEvent1":{
                        "value":{
                            "Power":"on",
                            "WF":"2"
                        },
                        "time":1524448722000
                    },
                    "alarmEvent2":{
                        "value":{
                            "Power":"on",
                            "WF":"2"
                        },
                        "time":1524448722000
                    }
                }
        }
    ]
}

表.请求参数说明

参数 类型 说明
id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
version String 物模型版本号，可选字段，不填默认为1.0
params Object 请求参数。
properties Object 属性，包含属性标识符、属性值value 和属性生成的时间time。其中，time参数为可选字段。根据您的业务场景决定消息中是否带时间戳。如果消息频繁，需根据时间戳判断消息顺序，建议消息中带有时间戳。
events Object 事件，包含事件标识符、事件输出参数value和事件生成的时间time。其中，time参数为可选字段。根据您的业务场景决定消息中是否带时间戳。如果消息频繁，需根据时间戳判断消息顺序，建议消息中带有时间戳。
identity Object 设备信息，可选字段，如果有此字段，内容为子设备信息
productID String 子设备产品key。
deviceName String 子设备名称。
  • 响应topic: $sys/{pid}/{device-name}/thing/pack/post/reply

OneJSON数据格式:

{
  "id": "123",
  "code": 200,
  "msg":"xxxx"
}

表.响应参数说明

参数 类型 说明
id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
code Integer 结果状态码
msg String 错误消息

6. 历史数据上报

上行(OneJSON)

  • 请求topic: $sys/{pid}/{device-name}/thing/history/post

    说明： 每次批量上送不超过10个子设备，每个设备上送数据点数量不超过100个，每个功能点历史数据不超过100个

OneJSON数据格式:

{
    "id":"123",
    "version":"1.0",
    "params":[
        {
            "identity":{
                "productID":"",
                "deviceName":""
            },
            "properties":{
                "Power":[
                    {
                        "value":"on",
                        "time":1524448722000
                    },
                    {
                        "value":"off",
                        "time":1524448723000
                    }
                ],
                "WF":[
                    {
                        "value":"3",
                        "time":1524448723000
                    },
                    {
                        "value":"3",
                        "time":1524448724000
                    }
                ]
            },
            "events":{
                "alarmEvent1":[
                    {
                        "value":{
                            "Power":"on",
                            "WF":"2"
                        },
                        "time":1524448722000
                    },
                    {
                        "value":{
                            "Power":"off",
                            "WF":"3"
                        },
                        "time":1524448723000
                    }
                ],
                "alarmEvent2":[
                    {
                        "value":{
                            "Power":"on",
                            "WF":"2"
                        },
                        "time":1524448722000
                    },
                    {
                        "value":{
                            "Power":"off",
                            "WF":"3"
                        },
                        "time":1524448723000
                    }
                ]
            }
        },
        {
            "identity":{
                "productID":"",
                "deviceName":""
            },
            "properties":{
                "Power":[
                    {
                        "value":"on",
                        "time":1524448722000
                    },
                    {
                        "value":"off",
                        "time":1524448723000
                    }
                ],
                "WF":[
                    {
                        "value":"3",
                        "time":1524448723000
                    },
                    {
                        "value":"3",
                        "time":1524448724000
                    }
                ]
            },
            "events":{
                "alarmEvent1":[
                    {
                        "value":{
                            "Power":"on",
                            "WF":"2"
                        },
                        "time":1524448723000
                    },
                    {
                        "value":{
                            "Power":"off",
                            "WF":"3"
                        },
                        "time":1524448724000
                    }
                ],
                "alarmEvent2":[
                    {
                        "value":{
                            "Power":"on",
                            "WF":"2"
                        },
                        "time":1524448723000
                    },
                    {
                        "value":{
                            "Power":"off",
                            "WF":"3"
                        },
                        "time":1524448724000
                    }
                ]
            }
        }
    ]
}

表 . 请求参数说明

参数 类型 说明
id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
version String 物模型版本号，可选字段，不填默认为1.0
params Object 请求参数。
identity String 数据所属设备的身份证书信息，包含参数productID和deviceName。可选字段，默认为topic信息中对应的设备数据；说明 直连设备仅能上报自己的物模型数据。网关设备可以上报其子设备的物模型数据。网关上报子设备历史数据时，identity为子设备的信息。
properties Object 属性，包含属性标识符、属性值value 和属性生成的时间time。
events Object 事件，包含事件标识符、事件输出参数value和事件生成的时间time。
productID String 子设备产品key。
deviceName String 子设备名称。
  • 响应topic: $sys/{pid}/{device-name}/thing/history/post/reply

OneJSON数据格式:

{
  "id": "123",
  "code": 200,
  "msg":"xxxx"
}

表.响应参数说明

参数 类型 说明
id String 消息id号，用户自定义，String类型的数字，长度限制不超过13位。
code Integer 结果状态码
msg String 错误消息

个搜索结果，搜索内容 “”

    0 个搜索结果，搜索内容 “”