文档首页> > API参考> IoT平台北向API参考> 接口列表> 消息推送> 设备命令响应通知

设备命令响应通知

更新时间: 2019-01-14 17:17

典型场景

第三方应用在物联网平台订阅了设备命令响应通知后(订阅的通知类型为commandRsp),当平台向设备下发命令,并收到设备返回的命令响应消息(如命令执行成功或者执行失败,设备要向平台返回指定内容响应)时,平台会向第三方应用推送通知消息。

接口功能

支持物联网平台向订阅了设备命令响应通知的第三方应用推送通知消息。

变更记录

接口版本

物联网平台版本

变更说明

1.1.0

V100R001C30

删除请求参数timestamp。

1.1.0

V100R001C10

新增接口。

注意事项

应用收到推送消息,请务必返回响应码。

接口原型

请求方法

POST

请求地址

由第三方应用订阅请求消息中的callbackurl决定。

传输协议

HTTPS

请求参数

参数

必选/可选

类型

位置

描述

notifyType

必选

String

body

通知类型,取值:commandRsp。

header

必选

Header

body

具体参见Header字段

body

必选

ObjectNode

body

响应命令的消息内容。

Header字段说明:

参数

必选/可选

类型

位置

描述

requestId

必选

String(1-128)

body

消息的序列号,唯一标识该消息。

from

必选

String(1-128)

body

表示消息发布者的地址。

  • 设备发起的请求:/devices/{deviceId}
  • 设备服务发起的请求:/devices/{deviceId}/services/{serviceId}

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

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

在文档使用中是否遇到以下问题







请至少选择或填写一项反馈信息

字符长度不能超过100

反馈内容不能为空!

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区