检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
应用服务器在物联网平台订阅了消息状态变更通知后（订阅的资源为device.message.status，事件为update），当消息状态变更时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅消息状态变更通知的callbackUrl决定
见下表RegDirectDeviceInDTO的描述。 appId 可选 String query 如果是本应用的设备，此参数值可以填写None，否则填写授权应用的appId。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 RegDirectDeviceInDTO
知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite SDK的设备。 注意事项
String body 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。 services 必选 List<DeviceServiceData> body
header 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 Authorization 必选 String header 访问物联网平台的认证信息，值为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。
No或IMEI作为nodeId。 说明： 使用IMEI作为nodeId时，根据不同厂家的芯片有不同填写要求。 高通芯片设备的唯一标识为urn:imei:xxxx，xxxx为IMEI号 海思芯片设备的唯一标识为IMEI号 其他厂家芯片的设备唯一标识请联系模组厂家确认。 endUserId 可选 String(256)
应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite SDK的设备。 注意事项 应用收到推送消息，请务必返回响应码。
调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接口，接口内容请参考物联网平台API参考中的消息推送章节。
应用服务器如何收到命令状态变化的通知？ 如何获取证书？ 回调地址可以使用域名吗？ 订阅后消息推送失败，例如提示503如何处理？ 应用服务器收到数据，但是平台显示推送失败？ 应用服务器只有内网地址，能否订阅成功？ 调用订阅接口时，提示回调地址不合法？ 物联网平台只支持HTTPS的回调地址吗？ 回调地址可以修改吗？
典型场景 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的nodeId，在设备de
在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，并设置设备的唯一标识（如IMEI）。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。 此注册设备接口适用于使用LWM2M/CoAP协议接入的设备，或者集成了AgentLite SDK的设备。 URI 请求方法 POST URI /iocm/app/reg/v1
址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接口，接口内容请参考物联网平台API参考中的消息推送章节。
址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接口，接口内容请参考物联网平台API参考中的消息推送章节。
若使用IMEI作为nodeId，根据不同厂家的芯片有不同填写要求。 高通芯片设备的唯一标识为urn:imei:xxxx，xxxx为IMEI号 海思芯片设备的唯一标识为IMEI号 其他厂家芯片的设备唯一标识请联系模组厂家确认。 timeout 可选 Number body 验证码超时时间，单位秒，取值大于等于0的整数。
址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接口，接口内容请参考物联网平台API参考中的消息推送章节。
调用API接口前建议完成Profile文件和编解码插件的开发。尽管接口的调用不依赖于Profile文件和编解码插件，但是由于profile文件定义了设备数据的字段，编解码插件是上报数据和下发命令时的必要条件，因此为了使得调用接口前的业务都正常，需要先行完成产品的开发。 为充分了解接口，建议提前获取
调用此接口后，SDK会启动一个线程自动刷新accessToken，且accessToken只在SDK内部管理，第三方应用不必关心；调用其他业务接口时，accessToken直接传入null即可（如果传入的accessToken不是null，则使用传入的accessToken）。 可以调用stopRefreshT
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实
要填写。 若使用IMEI作为nodeId，根据不同厂家的芯片有不同填写要求。 高通芯片设备的唯一标识为urn:imei:xxxx，xxxx为IMEI号 海思芯片设备的唯一标识为IMEI号 其他厂家芯片的设备唯一标识请联系模组厂家确认。 timeout 可选 Integer body
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
