Help Center/ IoT/ API Reference/ MQTT Interface Reference/ API Description/ Reporting Data
Updated on 2022-02-24 GMT+08:00
View PDF
Share

Reporting Data

Interface Function

This interface is used by the device to report data to the IoT platform.

Parameters

Parameter

Mandatory or Optional

Type

Description

msgType

Mandatory

String

This parameter has a fixed value of deviceReq, which indicates that the device reports data to the IoT platform.

data

Mandatory

ServiceData[]

Data of a group of services. When batch data needs to be uploaded, you can specify this parameter. For details about the parameter structure, see the following table.

ServiceData structure

Parameter

Mandatory or Optional

Type

Description

serviceId

Mandatory

String

Service ID.

serviceData

Mandatory

ObjectNode

Data of a service. The detailed parameters are defined in the profile file.

eventTime

Optional

String

Time when the device collects data. The format is yyyyMMddTHHmmssZ, for example, 20161219T114920Z.

If this parameter is not carried in the reported data or the parameter format is incorrect, the time when the IoT platform receives the data prevails.

Example

MQTT 
Topic: /huawei/v1/devices/{deviceId}/data/{codecMode} 
Payload sent by the MQTT client:
{ 
"msgType":"deviceReq", 
"data": [ 
{ 
"serviceId":"{serviceId}", 
"serviceData":{ 
"meterId":"xxxx", 
"dailyActivityTime":120, 
"flow": "565656", 
"cellId":"5656", 
"signalStrength":"99", 
"batteryVoltage":"3.5" 
} 
"eventTime":"20160503T121540Z" 
} , 
{ 
"serviceId": "Battery", 
"serviceData":  {"batteryLevel": 75}, 
"eventTime":"20160503T121540Z" 
} 
] 
}
Parent topic: API Description