Platform Delivering a Message

Function

This API is used by an application to deliver a message in custom format to a device when the application cannot deliver data in the format defined in the product model. You can also use the standard format encapsulated by the platform. That is, set payload_format to standard when using the API for message delivery on the application side. Alternatively, select by system format on the message delivery page of the device details page.

For differences between command delivery and message delivery, see Message Communications Overview.

It is not suitable to report data in JSON format for devices with low configuration and limited resources or with limits on bandwidth usage. In this case, devices can transparently transmit the original binary data to the platform, but a codec is required to convert binary data to JSON format. For details about how to develop codecs, see Developing a Codec.

Topic

Downstream: $oc/devices/{device_id}/sys/messages/down

Parameters

Example

System format:

Topic: $oc/devices/{device_id}/sys/messages/down
Data format:
{
    "object_device_id": "{object_device_id}",
    "name": "name",
    "id": "id",
    "content": "hello"
}

Customized format:

Topic: $oc/devices/{device_id}/sys/messages/down
Data format:
arbitrary content