消息类型

数据格式

业务数据

协议号

不同协议号代表不同的功能。

设备状态数据上报

• data 数据体说明

  code	数据类型	描述
  dataId	String	该条上报数据的唯一标识 ID，无业务含义
  devId	String	设备 ID
  productKey	String	设备所属的产品 ID
  status	List<StatusItem>	该次设备状态数据上报集

• StatusItem 说明

  code	数据类型	描述
  code	String	设备状态上报 code
  value	Object	设备状态上报 code 的状态值
  t	Long	设备状态上报时间戳，13 位
  “{dpId}”:“{dpValue}”	String:String	“数据点编码（产品定义时对应的数据点编码）”:“数据点对应的值”。您可选使用产品定义。

• 数据示例

  {
  "dataId":"AAXI3c1i6xxx***",
  "devId":"6c95a93fd9xxx***",
  "productKey":"awgmk9pixxx***",
  "status":[
      {
          "code":"switch_1",
          "value":false,
          "t":1628229842692,
          "1":"false"
      }
  ]
  }
  

设备上线

• bizData 说明

  code	数据类型	描述
  time	Long	时间戳

• 数据示例

  {
    "devId": "002dj00118fe34d9****",
    "productKey": "涂鸦 IoT 开发平台定义产品对应的产品 Key",
    "bizCode": "online",
    "bizData": {
      "time": 146052438362
    }
  }
  

设备离线

• bizData说明

  code	数据类型	描述
  time	Long	时间戳

• 数据示例

    {
      "devId": "002dj00118fe34d9****",
      "productKey": "涂鸦 IoT 开发平台定义产品对应的产品 Key",
      "bizCode": "offline",
      "bizData": {
        "time": 146052438362
      }
    }
  

修改设备名称

• bizData 说明

  code	数据类型	描述
  devId	String	设备 ID
  name	String	设备名称

• 数据示例

  {
    "devId": "002dj00118fe34d9****",
    "productKey": "涂鸦 IoT 开发平台定义产品对应的产品 Key",
    "bizCode": "nameUpdate",
    "bizData": {
      "devId": "002dj00118fe34d9****",
      "name": "new name"
    }
  }
  

修改设备功能点名称

• bizData 说明

  code	数据类型	描述
  devId	String	设备 ID
  name	String	DP 名称
  dpId	String	功能点 ID

• 数据示例

  {
    "devId": "002dj00118fe34d9****",
    "productKey": "涂鸦 IoT 开发平台定义产品对应的产品 Key",
    "bizCode": "dpNameUpdate",
    "bizData": {
      "devId": "002dj00118fe34d9****",
      "name": "new name",
      "dpId": "dpId"
    }
  }
  

设备绑定用户

• bizData 说明

  code	数据类型	描述
  devId	String	设备 ID
  uuid	String	设备硬件唯一标识
  uid	String	设备绑定者
  token	String	设备配网 Token

• 数据示例

  {
    "devId": "002dj00118fe34d9****",
    "productKey": "涂鸦 IoT 开发平台定义产品对应的产品 Key",
    "bizCode": "bindUser",
    "bizData": {
      "devId": "002dj00118fe34d9****",
      "uuid": "06200043b4e618c1****",
      "uid":"ay1529485403390****",
      "token": "IIpQ****"
    }
  }
  

删除设备

• bizData 说明

  code	数据类型	描述
  devId	String	设备 ID
  uid	String	设备绑定者

• 数据示例

  {
    "devId": "002dj00118fe34d9****",
    "productKey": "涂鸦 IoT 开发平台定义产品对应的产品 Key",
    "bizCode": "delete",
    "bizData": {
      "devId": "002dj00118fe34d9****",
      "uid":"ay1529485403390S****"
    }
  }
  

设备升级状态

• bizData 说明

  code	数据类型	描述
  devId	String	设备 ID
  moduleType	Integer	模块类型： 0：Wi-Fi 1：蓝牙 LE 2：GPRS
  upgradeStatus	Integer	升级状态： 1：准备升级 2：升级中 3：升级完成 4：升级异常 7：超时异常
  description	String	升级描述
  oldVersion	String	旧版固件
  newVersion	String	升级固件

• 数据示例

  {
      "bizCode":"upgradeStatus",
      "bizData": {
          "devId":"6ca8756d*****1b4ewsdn",
          "moduleType":0,
          "upgradeStatus":2,
          "description":"升级测试",
          "oldVersion": "1.0.1",
          "newVersion": "1.0.2"
      },
      "devId":"6ca8756d*****1b4ewsdn",
      "productKey":"vFHpaEFwu8UD****",
      "ts":1562232522192
  }
  

场景执行

• bizData 说明

  code	数据类型	描述
  name	String	场景名称
  id	String	场景 ID
  gid	Long	家庭 ID
  uid	String	场景添加者 UID
  ts	Long	消息投递时间戳
  actions.entityId	String	实体 ID
  actions.execStatus	Integer	状态： -1：默认 0：失败 1：成功 2：待执行 3：无需执行
  actions.executeTime	Long	执行时间(时间戳)
  actions.id	String	动作 ID
  actions.errorMsg	String	错误信息

• 数据示例

  {
     "bizData":{
      "name":"开关-开启",
      "id":"azmQ2w8kPSCdcr***",
      "actions":[
          {
              "entityId":"02167073cc****",
              "execStatus":1,
              "executeTime":1625798044277,
              "id":"1jPxz3zaNdL****"
          }
      ]
    },
   "gid":37081***,
   "uid":"ay1622715182388N****",
   "ts":1625798044298
  }