检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
注册设备（密码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，获取设备ID和密码。在设备接入物联网平台时携带设备ID和密码，完成设备的接入认证。 此注册设备接口适用于使用MQTT协议接入的设备。 URI 请求方法 POST URI /iocm/app/reg/v2
刷新设备密钥 接口说明 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），应用服务器需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 注意事项 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 URI 请求方法 PUT URI /iocm/app/reg/v1
配置“鉴权”接口的HTTP方法、URL。 参数 取值 HTTP方法 POST URL https://server:port/iocm/app/sec/v1.1.0/login 其中server:port为获取应用接入信息时获取的域名和端口。不能通过域名接入的设备，此处填写从2中获取的IP地址。 配置“鉴权”接口的Body。
创建设备组 接口说明 应用服务器可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 注意事项 一个设备只能归属一个设备组。 URI 请求方法 POST URI
订阅数据 应用服务器通过调用物联网平台的“订阅平台业务数据”接口，告知物联网平台消息推送的地址和通知类型，比如设备业务数据、设备告警等，接口信息详见API参考文档。 在订阅场景下，物联网平台是客户端，应用服务器是服务端，物联网平台调用应用服务器的接口，并向应用服务器推送消息。在Java
创建固件升级任务 接口说明 若需要对设备进行固件版本升级，应用服务器可调用此接口为多个设备创建固件升级任务，升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行固件升级。 URI 请求方法 POST URI /iodm/northbound/v1
查询任务列表 接口说明 应用服务器可调用此接口查询已创建的升级任务列表信息，以了解当前已有的升级任务信息及各个任务的执行情况，可根据条件查询满足要求的升级任务信息。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/operations 传输协议 HTTPS
查询指定版本包 接口说明 在进行设备版本升级前，应用服务器可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台，可根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。 URI 请求方法 GET URI /iodm/northbound/v1
行失败，执行成功，超时，发送，已送达）会通知应用服务器。 expireTime Integer(>=0) 下发命令的超时时间，单位为秒，表示设备命令在创建后expireTime秒内有效，超过这个时间范围后命令将不再下发，如果未设置则默认为48小时（86400s*2）。 status
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接口，接口内容
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接口，接
回调路径已在SDK中设置好了，所以在订阅时要注意设置对应的回调地址。回调的IP地址则是服务器的地址，需要是公网地址。Demo工程的回调端口配置在src\main\resource\application.properties中： 1 2 #specify the port of the
创建软件升级任务 接口说明 若需要对设备进行软件版本升级，应用服务器可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行软件升级。 URI 请求方法 POST URI /iodm/northbound/v1
鉴权 接口说明 应用服务器首次访问物联网平台的开放API时，需调用此接口完成认证鉴权，获取accessToken。 注意事项 鉴权接口是调用其他API的前提，除了调用鉴权接口，其他接口调用都需要在request header中携带参数app_key和Authorization。a
回调路径已在SDK中设置好了，所以在订阅时要注意设置对应的回调地址。回调的IP地址则是服务器的地址，需要是公网地址，端口自行配置。 回调证书制作 本章节以自签名证书为例。如果是使用商用证书，请直接向CA机构申请。 注：每个步骤的创建证书请求中的配置，请自行设置。“Common Name
接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用BindConfig.setConfig接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直连设备，之后在设备上发起绑定操作，将设备绑定到物联
批量查询设备信息 接口说明 已在物联网平台注册的设备，应用服务器若需要根据条件查看多个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 URI 请求方法 GET URI /iocm/app/dm/v1.4.0/devices 传输协议
查询单个设备信息 接口说明 已在物联网平台注册的设备，应用服务器若需要查看某个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 URI 请求方法 GET URI /iocm/app/dm/v1.4.0/devices/{deviceId}
接口说明 在创建了设备软件升级任务或固件升级任务后，任务中涉及的每个设备的升级是一个子任务（即升级任务中涉及多少个设备，就有多少个子任务）。应用服务器可调用此接口查询某个升级任务中各个子任务的详细信息，以查看子任务的具体执行情况。 URI 请求方法 GET URI /iodm/northbound/v1
若应用服务器需要调用物联网平台的API接口进行一些业务处理，请求中必须携带appId以接入对应的项目空间，鉴权接口携带在Body中，其他接口的appId的值一般携带在Header中。 创建项目后，可以在项目中查看应用服务器和设备的接入地址和端口信息，方便您快速对接应用服务器和设备。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
