Help Center> IoT Device Access> API Reference> 历史API> 设备侧MQTT接口参考> 设备上报数据
View PDF

设备上报数据

接口说明

设备向物联网平台上报数据。

Topic

Topic

/huawei/v1/devices/{deviceId}/data/{codecMode}

消息发送方

设备

消息接收方

物联网平台
“codecMode”为上报的编解码类型，有两个值，包括json和binary。
  1. 当设备需要使用开发的编解码插件进行数据解码时，“codecMode”取值为“binary”。
  2. 当设备不需要使用编解码插件进行解码时，“codecMode”取值为“json”。

参数说明

参数

必选/可选

类型

描述

msgType

必选

String

固定值“deviceReq”，表示设备上报数据。

data

必选

List<ServiceData>

要上报的设备数据。

ServiceData：

参数

必选/可选

类型

描述

serviceId

必选

String

设备服务的ID。

serviceData

必选

ObjectNode

一个服务下的属性数据，具体字段在设备的产品模型中定义。

eventTime

可选

String

设备采集数据的UTC时间（格式：yyyyMMddTHHmmssZ），如：20161219T114920Z。

设备上报数据不带该参数或参数格式错误时，则数据上报时间以物联网平台时间为准。

示例

设备向Topic发送的payload： 
{ 
   "msgType":"deviceReq", 
   "data": [ 
   { 
      "serviceId":"******", 
      "serviceData":{ 
        "meterId":"******", 
        "dailyActivityTime": 120, 
        "flow": "565656", 
        "cellId":"5656", 
        "signalStrength":"99", 
        "batteryVoltage":"3.5" 
       },
      "eventTime":"20160503T121540Z" 
   },
   { 
      "serviceId": "Battery", 
      "serviceData": {
         "batteryLevel": 75
      }, 
      "eventTime":"20160503T121540Z" 
   }
   ] 
}