检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
的平台环境为商用环境，两个环境的数据不能互通，已对接测试环境的设备/应用服务器要迁移商用环境，您需要通过本章节的指引完成商用对接。 总体说明 迁移对接的过程中，开发中心数据不割接，由应用服务器负责保存设备在开发中心的历史数据。 建议应用服务器先迁移商用环境再迁移设备，设备迁移采用API逐个重新注册的方式。
由平台生成随机psk参数。 在物联网平台上查看注册的设备。 进阶体验 按照本页面的指导，使用Postman模拟应用服务器接入物联网平台后，您应该已经基本了解应用服务器如何通过调用物联网平台开放的接口与平台交互。 若您想要进一步体验设备管理服务，可参考开发指南开发真实应用和真实设备，并接入物联网平台，体验更多功能。
注册设备（密码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，获取设备ID和密码。在设备接入物联网平台时携带设备ID和密码，完成设备的接入认证。 此注册设备接口适用于使用MQTT协议接入的设备。 URI 请求方法 POST URI /iocm/app/reg/v2
刷新设备密钥 接口说明 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），应用服务器需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 注意事项 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 URI 请求方法 PUT URI /iocm/app/reg/v1
删除指定版本包 接口说明 对于不需要继续使用和保留的设备版本包，应用服务器可调用此接口在物联网平台上删除指定的版本包，可根据版本包ID删除指定的版本包文件，在调用该接口前需要通过“查询版本包列表”接口查询获得要删除的版本包ID。 URI 请求方法 DELETE URI /iodm/northbound/v1
若应用服务器需要调用物联网平台的API接口进行一些业务处理，请求中必须携带appId以接入对应的项目空间，鉴权接口携带在Body中，其他接口的appId的值一般携带在Header中。 创建项目后，可以在项目中查看应用服务器和设备的接入地址和端口信息，方便您快速对接应用服务器和设备。
平台无法正常显示设备上报的历史数据怎么处理？ 如何理解命令下发各个状态的含义？ 命令下发失败或设备收不到命令如何处理？ 应用服务器调用接口失败怎么处理？ 应用服务器如何获取设备上报的数据？ 如何制作订阅推送调测证书？ 调用订阅接口时，回调地址如何获取？ 订阅后消息推送失败如何处理？
状态变更为“成功”。 失败（FAIL） 如果设备在执行完命令后，会给物联网平台反馈命令执行失败的结果，将任务状态变更为“失败”。 NB-IoT设备采用立即下发模式下发命令时，如果设备离线，状态为“失败”。 MQTT设备下发命令时，如果设备离线，状态为“失败”。 相关API接口 创建设备命令
设备接入服务如何获取设备数据？ 设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 需要注意的是设备接入服务不解析数据，若设备采用二进制上报数据，则平台进行码流base64封装后再转发。 父主题： 方案咨询（联通用户专用）
查询指定版本包 接口说明 在进行设备版本升级前，应用服务器可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台，可根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。 URI 请求方法 GET URI /iodm/northbound/v1
同步数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。
下发命令的信息。 callbackUrl 可选 String(1024) body 命令状态变化通知地址，当命令状态变化时（执行失败，执行成功，超时，发送，已送达）会通知应用服务器。 expireTime 可选 Integer(>=0) body 下发命令的有效时间，单位为秒，表示设备命令在创
升级任务有重试策略，当群组中有部分设备升级失败后，是如何重试的？ 当整个任务失败后，只重试失败的子任务，已升级成功的设备不会再重试。 软件升级可以配置重试时间和重试次数，固件只能配置重试次数。 父主题： 软/固件升级（联通用户专用）
数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口
鉴权 接口说明 应用服务器首次访问物联网平台的开放API时，需调用此接口完成认证鉴权，获取accessToken。 注意事项 鉴权接口是调用其他API的前提，除了调用鉴权接口，其他接口调用都需要在request header中携带参数app_key和Authorization。a
创建设备组 接口说明 应用服务器可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 注意事项 一个设备只能归属一个设备组。 URI 请求方法 POST URI
日志路径（若日志路径为空则日志写在工作路径中）。 context 必选 Context Android应用程序上下文。 接口返回值 返回值 描述 true 成功。 false 失败。 示例 1 2 // 开发者调用该接口初始化Agent Lite资源 BaseService.in
发者参考。 SDK提供JAVA方法调用物联网平台的API接口与平台通信。 消息推送回调使用JAVA代码实现回调接口，供平台推送消息给应用服务器时调用，应用通过继承PushMessageReceiver类并重写类中的方法接收推送消息的内容。 Test API提供测试SDK接口的功能
SDK提供Python方法调用物联网平台的API接口与平台通信。 消息推送回调使用Python代码实现回调接口，供平台推送消息给应用服务器时调用，应用通过继承PushMessageReceiver类并重写类中的方法接收推送消息的内容。 Test API提供测试SDK接口的功能
中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接口，接口内容
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
