更新时间:2023-04-13 GMT+08:00
分享

设备命令响应通知

接口说明

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

仅适用于使用MQTT协议接入的设备,例如集成了AgentLite SDK的设备。

注意事项

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

URI

请求方法

POST

URI

由应用服务器订阅请求消息中的callbackurl决定。

传输协议

HTTPS/HTTP

请求参数

参数

必选/可选

类型

位置

描述

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

请求示例

POST {callbackUrl}
Content-Type: application/json

{
  "notifyType": "commandRsp",
  "header": {
    "requestId": "***********",
    "from": "***********",
    "to": "***********",
    "deviceId": "***********",
    "serviceType": "Camera",
    "method": "MUTE_COMMANDS"
  },
  "body": {

  }
}

正常响应示例

Status Code: 200 OK
分享:

    相关文档

    相关产品