检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备组列表 接口说明 应用服务器可调用此接口查询当前已创建的所有设备组列表信息，以了解当前设备组的分组和使用情况。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups 传输协议 HTTPS 请求参数 参数 必选/可选 类型
注册设备（密码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，获取设备ID和密码。在设备接入物联网平台时携带设备ID和密码，完成设备的接入认证。 此注册设备接口适用于使用MQTT协议接入的设备。 URI 请求方法 POST URI /iocm/app/reg/v2
也称为回调地址（什么是回调地址？）。如果应用服务器没有订阅该类型的数据通知，即使数据发生了变更也不会进行推送。物联网平台进行数据推送时，数据格式为JSON格式，推送协议可以采用HTTP或HTTPS协议，其中HTTPS协议为加密传输协议，需要进行安全认证，更加安全，推荐使用。 订阅推送的示意图如下图所示：
0/deviceCapabilities 传输协议 HTTPS 请求参数 参数 必选/可选 类型 位置 描述 app_key 必选 String header 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 Authorization 必选 String header 访问物联网平台的认证信息，值为“Bearer
订阅平台管理数据 接口说明 应用服务器可调用此接口向物联网平台订阅设备相关的管理数据，当设备进行版本升级等相关操作时，平台会向应用服务器发送通知消息，知会其具体的操作状态或操作结果信息。 URI 请求方法 POST URI /iodm/app/sub/v1.1.0/subscribe
修改设备命令 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令，且当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。
批量查询订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看本应用下所有订阅配置，或者查看某种订阅类型下的所有订阅配置，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当设备接入并绑定物联网平台时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。 传输协议 HTTPS/HTTP 请求参数 参数 必选/可选 类型 位置 描述 notifyType 必选 String body 通知类型，取值：deviceInfoChanged。
查询设备影子历史数据 接口说明 应用服务器通过“修改设备影子”接口修改设备影子的配置时，物联网平台会保存修改记录。当应用服务器需要查看设备影子的历史配置记录时，可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/shadow/v1.5.0/deviceDesiredHistory
应用服务器如何下发缓存命令？ 在调用“创建设备命令”接口时，“expireTime”参数设置为大于0的值。 “expireTime”为下发命令的超时时间，单位为秒，表示设备命令在创建后expireTime秒内有效，超过这个时间范围后命令将不再下发，如果未设置则默认为48小时（86400s*2）。
注册设备（验证码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，并设置设备的唯一标识（如IMEI）。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。 此注册设备接口适用于使用LWM2M/CoAP协议接入的设备，或者集成了AgentLite SDK的设备。
设备消息状态变更通知 接口说明 应用服务器在物联网平台订阅了消息状态变更通知后（订阅的资源为device.message.status，事件为update），当消息状态变更时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
批量任务状态变更通知 接口说明 应用服务器在物联网平台订阅了批量任务状态变更通知后（订阅的资源为batchtask.status，事件为update），当批量任务状态变更时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
物联网平台订阅推送是否具有重推机制？ 物联网平台具有重推机制，机制如下： 物联网平台向应用服务器推送消息后，如果应用服务器接收消息成功，会向物联网平台返回200 OK响应码。如果应用服务器无响应（响应超时时长15秒）或者应用服务器向物联网平台返回501、502、503、504响应码，表示消息推送失败
文件获取。 物联网平台通过HTTPS或HTTP协议向应用服务器推送数据，当使用HTTPS协议时需要在物联网平台上加载CA证书，同时在应用服务器上加载设备证书，用于物联网平台校验应用服务器合法性。在调测时，您可以通过制作自签名证书进行调测。在商用时，建议您向证书知名机构申请和购买商用证书，以确保证书的安全性。
接口说明 应用服务器在物联网平台订阅了设备消息上报通知后（订阅的资源为device.message，事件为report），当设备上报消息数据时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设
订阅的回调地址，用于接收对应资源事件的通知消息。 channel String 物联网平台推送通知消息时使用的协议通道。使用“http”填充，表示该订阅推送协议通道为http(s)协议。 表1 Subject 名称 类型 说明 resource String 订阅的资源名称。 device：设备。
应用服务器调用接口失败怎么处理？ 请检查应用服务器的网络连接情况，确保应用服务器网络正常。 检查请求中物联网平台的应用接入地址和端口是否正确。 使用“ping {物联网平台应用接入地址}”命令，查看应用服务器是否可以正常访问物联网平台的应用接入地址。 使用“telnet {物联网平台应用接入地址}
创建固件升级任务 接口说明 若需要对设备进行固件版本升级，应用服务器可调用此接口为多个设备创建固件升级任务，升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行固件升级。 URI 请求方法 POST URI /iodm/northbound/v1
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
