Subscribing to Service Data of the IoT Platform

sdbdInDTO

Mandatory

SubDeviceBusinessDataInDTO

body

For details, see SubDeviceBusinessDataInDTO structure.

accessToken

Mandatory

String

header

This parameter is set to the value of the access token obtained by calling the Authentication API.

ownerFlag

Optional

String(256)

query

Indicates the owner flag of the callback URL.

• false: The callback URL owner is an authorizing application.
• true: The callback URL owner is an authorized application.

appId

Optional

String(256)

body

Indicates the application ID of the device.

notifyType

Mandatory

String

body

Indicates the notification type based on which an NA can receive notification messages pushed by the IoT platform. The value options are as follows:

• bindDevice: device binding; sending such a notification after subscription
• deviceAdded: device addition; sending such a notification after subscription
• deviceInfoChanged: device information change; sending such a notification after subscription
• deviceDataChanged: device data change; sending such a notification after subscription
• deviceDatasChanged: batch device data change; sending such a notification after subscription
• deviceDeleted: device deletion; sending such a notification after subscription
• messageConfirm: message confirmation; sending such a notification after subscription
• commandRsp: command response; sending such a notification after subscription
• deviceEvent: device event; sending such a notification after subscription
• serviceInfoChanged: service information change; sending such a notification after subscription
• deviceModelAdded: device model addition; sending such a notification after subscription
• deviceModelDeleted: device model deletion; sending such a notification after subscription
• deviceDesiredPropertiesModifyStatusChanged: device shadow modification status change; sending such a notification after subscription

callbackUrl

Mandatory

String(1024)

body

Indicates the callback URL of a subscription, which is used to receive notification messages of the corresponding type.

This URL must be an HTTPS channel callback URL and contain its port number. An example value is https://XXX.XXX.XXX.XXX:443/callbackurltest.

NOTE:

The HTTP channel can be used only for commissioning.

channel

Optional

String(32)

Body

Indicates the transmission channel. For the MQTT client, the value is MQTT. In other cases, the value is HTTP.

subscriptionId

String

Identifies a subscription.

notifyType

String

Indicates the notification type.

callbackUrl

String

Indicates the callback URL of the subscription.

400

100222

The request callbackurl is illegal.

The callback URL is invalid.

Recommended handling: Check whether the callback URL in the request body is correct.

403

100217

The application hasn't been authorized.

The application has not been authorized.

Recommended handling: In scenarios where applications are not authorized, ensure that request parameter appId is null.

403

1010009

app throttle exceed.

The NA calls the API at a frequency that exceeds the flow control threshold (100 calls per minute by default).

Recommended handling: Contact IoT platform maintenance personnel to adjust the flow control threshold or control the API call frequency.

403

1010005

App_key or access_token is invalid.

The access token is invalid.

Recommended handling: Check whether accessToken carried in the API request is correct.

409

100227

The resource is conflicted.

A resource conflict occurs. The notification type has been subscribed to.

Recommended handling: Check whether the notification type has been subscribed.