检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
物联网平台向应用侧开放了丰富的Restful API。本文档以Postman为例，模拟应用服务器以HTTPS协议为例接入物联网平台。 前提条件 已经注册华为云官方帐号，可点击注册页面完成注册。 已经在华为云上完成实名制认证，可点击实名认证完成认证。 已开通设备管理服务，可访问设备管理服务，点击“立即使用”后开通服务。
传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器地址，为“host:port”格式，host为服务器的访问域名或IP，port为服务器的访问端口，您可以参考平台对接信息获取应用的接入地址和端口信息。 例如设备管理服务在“华北-北
设备接入服务如何获取设备数据？ 设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 需要注意的是设备接入服务不解析数据，若设备采用二进制上报数据，则平台进行码流base64封装后再转发。 父主题：
IoT设备如何激活？ 在物联网平台中，激活就是将真实设备在平台进行注册后，和平台进行连接或者上报数据。更多请查看设备监控。 开发中心没有未激活状态，设备在线，您可认为设备就已激活。 父主题： 设备集成（联通用户专用）
调用订阅接口时，回调地址如何获取？ 以业务应用订阅设备数据变化通知为例，订阅和推送的流程如下： 应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知（携带回调地址和通知类型），物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。
固件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
务也只保存7天的历史数据。 若您希望长期保存数据，可以选择让平台将设备上报数据推送给应用服务器，由应用服务器进行保存；还可以选择让平台将设备上报数据转发给对象存储服务（OBS），由OBS进行存储。 本示例为将所有设备上报的数据转发至OBS存储。 创建OBS桶 登录华为云官方网站，访问对象存储服务。
软件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
订阅推送（联通用户专用） 调用订阅接口时，回调地址如何获取？ 应用服务器如何收到命令状态变化的通知？ 如何获取证书？ 回调地址可以使用域名吗？ 订阅后消息推送失败，例如提示503如何处理？ 应用服务器收到数据，但是平台显示推送失败？ 应用服务器只有内网地址，能否订阅成功？ 调用订阅接口时，提示回调地址不合法？
如何设置设备名称？ 在开发中心注册设备时，支持设置设备名称。 在设备接入和设备管理的控制台中注册设备时，不支持设置设备名称，您可在设备注册成功后，进入设备详情中新增/修改设备名称。 使用API注册/创建设备时，设备接入、设备管理和开发中心都支持在注册/创建设备时设置设备名称。 父主题：
订阅平台业务数据 接口说明 应用服务器可调用此接口在物联网平台订阅设备相关的业务信息，当设备的业务信息发生变化时（如设备注册、设备数据上报、设备状态变更等），平台会向应用服务器发送通知消息。 URI 请求方法 POST URI /iocm/app/sub/v1.2.0/subscriptions
批量查询订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看本应用下所有订阅配置，或者查看某种订阅类型下的所有订阅配置，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions
pem）、应用服务器证书（server.cer/server.crt/server.pem）和私钥文件（server_private.key）。其中CA证书用于加载到物联网平台，应用服务器证书和私钥文件用于加载到应用服务器。 加载证书 物联网平台采用HTTPS协议向应用服务器推送消息时
查询单个订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看某个订阅的配置信息，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId}
数据上报失败如何处理？ 若设备是使用接口注册的，请确认设备是否因为没在指定的timeout时间内上线而被物联网平台自动删除了。如果设备已被删除，请重新注册设备再尝试上报数据。 请检查使用接口注册设备时，填写的产品信息是否和产品profile一致。 请检查上报的数据名称是否和产品模型定义的服务属性一致。
平台支持从第三方服务器下载软/固件包吗？ 不支持。目前只支持将软/固件包直接上传至物联网平台，上传的位置为控制台的“设备管理 > 软件库 > 固件包管理”和“设备管理 > 软件库 > 软件包管理”。 父主题： 软/固件升级（联通用户专用）
请向证书申请人员获取。 支持SNI 默认不勾选，如果接收推送消息的服务器存在多个服务器使用同一个“IP+端口”，则需要勾选支持SNI，“CNNAME”填写需要接收消息的服务器的域名地址，以便服务器根据指定的域名携带对应的设备证书。 使用设备证书 保持默认值：关闭 父主题： 应用管理
物联网平台具有重推机制，机制如下： 物联网平台向应用服务器推送消息后，如果应用服务器接收消息成功，会向物联网平台返回200 OK响应码。如果应用服务器无响应（响应超时时长15秒）或者应用服务器向物联网平台返回501、502、503、504响应码，表示消息推送失败，物联网平台会将消息进行缓存（缓存10分钟），然
应用服务器下发命令失败，收到403的错误，提示回调地址冲突？ 通过开发中心的“订阅调试”界面或者调用“批量查询订阅”接口查看订阅地址。 同一个应用下，各订阅类型的回调地址的IP和端口号需要一致。 查看应用侧调用创建设备命令接口带的参数callbackurl，与订阅回调地址的IP和
为什么设备上报一条数据后应用服务器会收到多条推送？ 可能有以下几种情况： 如果订阅的“notifyType”为“deviceDataChanged”，且多条消息推送的内容不同，可能是因为设备上报的数据包含了多个service（即“data”参数内包括多个JSON对象），物联网平台会将其拆成多条消息推送。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
