Pushing a Device Command Response Notification
Typical Scenario
After an application subscribes to device command response notifications (the notification type is commandRsp) on the platform, the platform sends a notification to the application when the platform delivers a command to the device and the device returns a command response message (for example, the command execution succeeds or fails).
API Function
This API is used by the platform to push notifications to an application that has subscribed to device command response notifications.
Note
- When Subscribing to Device Service Data, an application must subscribe to the specified callback URL in the API description. The server and port in the callback URL are the public IP address and specified port of the application server.
- An application receives the content of a push message by inheriting the PushMessageReceiver class and overriding the callback API.
- If the callback URL is not the address of the application server, the application must implement the original callback API. For details on the API content, see Message Push in the Northbound API Reference.
API Description
| Callback URL | https://server:port/v1.0.0/messageReceiver |
|---|---|
| Callback API | def handleCommandRsp(self) |
| Class | PushMessageReceiver |
Parameter Description
The input parameter is request.json.
| Parameter | Mandatory or Optional | Type | Location | Description |
|---|---|---|---|---|
| ncrDTO | Mandatory | NotifyCommandRspDTO | body | For details, see NotifyCommandRspDTO structure. |
NotifyCommandRspDTO structure
| Parameter | Mandatory or Optional | Type | Location | Description |
|---|---|---|---|---|
| notifyType | Mandatory | String | body | Indicates the notification type. The value is commandRsp. |
| header | Mandatory | CommandRspHeader | body | For details, see CommandRspHeader structure. |
| body | Mandatory | ObjectNode | body | Indicates the content of the message body of the response command. |
| Parameter | Mandatory or Optional | Type | Location | Description |
|---|---|---|---|---|
| requestId | Mandatory | String(1-128) | body | Indicates the sequence number of the message, which uniquely identifies the message. |
| from | Mandatory | String(1-128) | body | Indicates the address of the message sender.
|
| to | Mandatory | String(1-128) | body | Indicates the address of the message recipient. The value is that of from in the request, for example, the user ID of the application. |
| deviceId | Mandatory | String | body | Uniquely identifies a device. |
| serviceType | Mandatory | String | body | Indicates the type of the service to which a command belongs. |
| method | Mandatory | String(1-128) | body | Indicates a stored response command, for example, INVITE-RSP. |
Response Parameters
Status Code: 200 OK
Request Example
Method: POST
request: {callbackUrl}
Header:
Content-Type:application/json
Body:
{
"notifyType":"commandRsp",
"header":{
"requestId":"***********",
"from":"***********",
"to":"***********",
"deviceId":"***********",
"serviceType":"Camera",
"method":"MUTE_COMMANDS"
},
"body":{
}
} Normal Response Example
response: Status Code: 200 OK
Last Article: Pushing a Message Acknowledgment Notification
Next Article: Pushing a Device Event Notification
Did this article solve your problem?
Thank you for your score！Your feedback would help us improve the website.