设备命令响应通知
典型场景
应用服务器在物联网平台订阅了设备命令响应通知后(订阅的通知类型为commandRsp),当平台向设备下发命令,并收到设备返回的命令响应消息(如命令执行成功或者执行失败,设备要向平台返回指定内容响应)时,平台会向应用服务器推送通知消息。
仅适用于使用MQTT协议接入的设备,例如集成了AgentLite SDK的设备。
接口功能
支持物联网平台向订阅了设备命令响应通知的应用服务器推送通知消息。
注意事项
应用收到推送消息,请务必返回响应码。
接口原型
请求方法 |
POST |
---|---|
请求地址 |
由应用服务器订阅请求消息中的callbackurl决定。 |
传输协议 |
HTTPS/HTTP |
请求参数
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
notifyType |
必选 |
String |
body |
通知类型,取值:commandRsp。 |
header |
必选 |
Header |
body |
具体参见Header字段。 |
body |
必选 |
ObjectNode |
body |
响应命令的消息内容。 |
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
requestId |
必选 |
String(1-128) |
body |
消息的序列号,唯一标识该消息。 |
from |
必选 |
String(1-128) |
body |
表示消息发布者的地址。
|
to |
必选 |
String(1-128) |
body |
表示消息接收者的地址,To就是订阅请求中的From,如应用服务器的userId。 |
deviceId |
必选 |
String |
body |
设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 |
serviceType |
必选 |
String |
body |
命令所属的服务类型。 |
method |
必选 |
String(1-128) |
body |
存放的响应命令,如:INVITE-RSP。 |
响应参数
Status Code: 200 OK
请求示例
Method: POST request: {callbackUrl} Header: Content-Type: application/json Body: { "notifyType": "commandRsp", "header": { "requestId": "***********", "from": "***********", "to": "***********", "deviceId": "***********", "serviceType": "Camera", "method": "MUTE_COMMANDS" }, "body": { } }
响应示例
response: Status Code: 200 OK