Help Center/ ROMA Connect/ Developer Guide/ Developer Guide for Device Integration/ MQTT Topic Specifications/ Reporting Device Data
Updated on 2025-07-21 GMT+08:00
View PDF

Reporting Device Data

Topic

Topic

/v1/devices/{gatewayId}/datas

Publisher

Edge device

Subscriber

IoT platform

Parameter Description

Field

Mandatory/Optional

Type

Description

devices

Mandatory

DeviceS[]

Device data.

DeviceS struct description

Field

Mandatory/Optional

Type

Description

deviceId

Mandatory

String(256)

Unique device ID generated by the IoT platform, which corresponds to the device client ID.

services

Mandatory

List<Services>

Service list.

Services struct description

Field

Mandatory/Optional

Type

Description

serviceId

Mandatory

String(256)

Service ID.

data

Mandatory

ObjectNode

Service data.

eventTime

Mandatory

String(256)

Time. The format is yyyyMMdd'T'HHmmss'Z', for example, 20151212T121212Z.

Example

{
       "devices": [{
              "deviceId": "D68NZxB4",
              "services": [{
                     "data": {
                            "key": "value"
                     },
                     "eventTime": "20191023T173625Z",
                     "serviceId": "serviceName"
              }]
       }]
}