BV JSON格式

BV JSON 是用于实体数据交互的统一标准格式。

实体注册

字段名称 字段类型 说明 是否必传
productId string 产品的唯一标识符 是
deviceId string 实体在产品下的唯一标识符 是
deviceName string 实体名称 是
deviceStatus number 实体状态 0未启用 1已启用（默认） 否
deviceType number 实体类型0 动态资源（默认） 1 静态资源 否
location string 实体位置纬经度（默认0 0 0 = latitude longitude elevation） 否
timestamp number 上行数据传输时间。时间戳格式为数值，值为自GMT 1970年1月1日0时0分到当前时间点所经过的毫秒数，非必传 否
version string 版本号。若不传入此参数，则默认default 否
payload object 上报的参数。说明事件上报时，为事件的输出参数；属性上报时为属性参数； 否

示例

 {
        "productId": "ovw9GOl46TSqbedc",
        "deviceId": "d0ca3710-1575-4977-88a6-ee852082948b",
        "deviceName": "设备1739255549",
        "deviceStatus": 0,
        "payload": {
            "ipAddress": "164.27.227.218",
            "switchStatus": true,
            "brandInformation": "划见五选",
            "scheduledOnTime": "14:00:00",
            "scheduledOffTime": "14:32:29",
            "humidity": "0.13°",
            "temperature": "0.82°",
            "networkType": "IPv4",
            "connectionStatus": "已连接",
            "productModel": "面影好织世",
            "currentAndVoltage": {
                "realTimeVoltage": 220,
                "realTimeCurrent": 0.89
            },
            "powerRelated": {}
        }
    }

属性(事件)上报

字段名称 字段类型 说明 是否必传
method number 上行数据类型的标识。0属性上报；1事件上报； 是
productId string 产品的唯一标识符 是
deviceId string 实体在产品下的唯一标识符 是
deviceSecret string 实体密钥与deviceID同时存在 否
deviceName string 实体名称 否
deviceStatus number 实体状态 0未启用 1已启用（默认） 否
identifier string 事件唯一标识符（事件时必传） 否
location string 实体位置纬经度（默认0 0 0 = latitude longitude elevation） 否
timestamp number 上行数据传输时间。时间戳格式为数值，值为自GMT 1970年1月1日0时0分到当前时间点所经过的毫秒数 否
version string 版本号。若不传入此参数，则默认default 否
payload object 上报的参数。说明事件上报时，为事件的输出参数；属性上报时为属性参数； 否

示例

{
    "method": 0,
    "productId":"ovw9GOl46TSqbedc",
    "deviceId": "b28baf9c-40cc-4fe7-9488-8bc28f28717f",
    "deviceStatus": 0,
    "payload": {
        "ipAddress": "142.82.172.41",
        "switchStatus": false,
        "brandInformation": "出少素格",
        "scheduledOnTime": "14:00:00",
        "scheduledOffTime": "14:31:29",
        "humidity": "0.84°",
        "temperature": "0.43°",
        "networkType": "IPv4",
        "connectionStatus": "已连接",
        "productModel": "技特国",
        "currentAndVoltage": {
            "realTimeVoltage": 220,
            "realTimeCurrent": 0.57
        },
        "powerRelated": {}
    }
}
作者：北京-产品-yantings  创建时间：2025-03-05 11:52
最后编辑：北京-产品-yantings  更新时间：2026-07-07 18:14
上一篇：
下一篇：