本文导读

展开导读

文档首页/ IoT物联网/ API参考/ 北向PHP SDK API参考/ 业务接口列表/ 消息推送/ 设备消息确认通知

设备消息确认通知

更新时间：2022-02-24 GMT+08:00

查看PDF

典型场景

第三方应用在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向第三方应用推送通知消息。

接口功能

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

注意事项

应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。
应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容。
如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接口，接口内容请参考IoT平台北向API参考中的消息推送章节。

接口描述

回调地址	https://server:port/v1.0.0/messageReceiver
回调接口	function handleMessageConfirm(NotifyMessageConfirmDTO $body)
接口所属类	PushMessageReceiver

参数说明

NotifyMessageConfirmDTO

参数	必选/可选	位置	描述
$notifyType	必选	body	通知类型，取值：“messageConfirm”。
$header	必选	body	具体参见下表MessageConfirmHeader结构说明。
$body	必选	body	根据业务具体定义，确认消息可以携带的状态变化等消息。

MessageConfirmHeader结构说明：

参数	必选/可选	位置	描述
$requestId	必选	body	消息的序列号，唯一标识该消息。
$from	必选	body	表示消息发布者的地址。设备发起的请求：“/devices/{deviceId}” 设备服务发起的请求：“/devices/{deviceId}/services/{serviceId}”
$to	必选	body	表示消息接收者的地址，To就是订阅请求中的From，如第三方应用的userId。
$status	必选	body	命令状态。 “sent”：已发送 “delivered”：已送达 “executed”：已执行
$timestamp	必选	body	时间戳，时间格式：yyyyMMdd'T'HHmmss'Z'，如：“20151212T121212Z”。

响应参数

Status Code: 200 OK

请求示例

Method: POST
request: {callbackUrl}
Header:
Content-Type:application/json
Body:
{
    "notifyType":"messageConfirm",
    "header":{
        "requestId":"***********",
        "from":"***********",
        "to":"***********",
        "status":"delivered",
        "timestamp":"20151212T121212Z"
    },
    "body":{

    }
}

响应示例

response:
Status Code: 200 OK

父主题： 消息推送

上一篇：删除设备通知

下一篇：设备命令响应通知

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消