检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
应用服务器收到数据，但是平台显示推送失败？ 根本原因是应用服务器收到数据后未向物联网平台返回200 OK状态码。 平台推送15秒后未收到应用服务器状态码，表示消息推送失败，物联网平台会将消息进行缓存（缓存10分钟），然后进行推送重试，缓存时间超时后如果还未推送成功，物联网平台不再进行推送重试。 父主题： 订阅推送（联通用户专用）
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo);
Integer(64) 等待操作的设备个数。 processing Integer(64) 正在操作的设备个数。 success Integer(64) 操作设成功的设备个数。 fail Integer(64) 操作失败的设备个数。 stop Integer(64) 停止操作的设备个数。 timeout
标签键，在同一资源下标签键唯一。绑定资源时，如果设置的键已存在，则将覆盖之前的标签值。如果设置的键值不存在，则新增标签。 tag_value 可选 String 标签值。 请求示例 POST 由应用服务器订阅设备消息上报通知的callbackUrl决定 Content-Type:
若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方应用查询单个设备的设备影子信息，包括对设备的配置信息（desi
典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。第三方应用可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。 接口功能
String body 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。此处填写授权应用的appId。 deviceType 必选 String body 设备的类型。 manufacturerName 必选 String body 设备模型的厂商名称。 manufacturerId
批量查询设备信息列表 典型场景 已在物联网平台注册的设备，第三方应用若需要根据条件查看多个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据条件查询多个设备的详细信息，包括配置信息、状态信息、服务属性信息等。
批量查询设备信息列表 典型场景 已在物联网平台注册的设备，第三方应用若需要根据条件查看多个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据条件查询多个设备的详细信息，包括配置信息、状态信息、服务属性信息等。
第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。
第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。
String(1-64) 第三方应用的身份标识，用于唯一标识一个应用。开发者可通过该标识来指定哪个应用来调用物联网平台的开放API。 deviceId String(1-64) 下发命令的设备ID，用于唯一标识一个设备。 command CommandDTOV4 下发命令的信息，具体参见CommandDTOV4结构体。
修改设备组 典型场景 若因业务变更需要修改设备组的信息，如设备组名称、设备组的设备数量限制等，第三方应用可调用此接口修改指定设备组的信息。 接口功能 支持第三方应用在物联网平台修改指定设备组的信息。 接口描述 1 ModifyDeviceGroupOutDTO modifyDev
软/固件包及其版本号如何获取？ 软件升级包及其版本号需向设备厂家获取，固件升级包及其版本号需向模组厂家获取。 父主题： 软/固件升级（联通用户专用）
支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3
备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务，该任务用于撤销物联网平台中指定设备ID下所有未下发的命令（命令处于DEFAULT状态）。
备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务，该任务用于撤销物联网平台中指定设备ID下所有未下发的命令（命令处于DEFAULT状态）。
header 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 Authorization 必选 String header 访问物联网平台的认证信息，值为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。
使用API对接 API使用指导（联通用户专用） 使用Postman调测（联通用户专用） 使用Java API Demo调测（联通用户专用） 父主题： 应用侧开发
典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时，物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时，可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID，在物联网平台查询指定设备影子的历史配置数据。 接口描述 1 QueryDeviceDesiredHistoryOutDTO
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
