检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口说明 应用服务器在物联网平台订阅了设备激活通知后(订阅的资源为device,事件为activate),当设备首次接入物联网平台并激活时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设备激活通知中的callbackUrl决定
可查询绑定在该应用上的应用服务器与物联网平台进行数据对接的端口信息。 应用和设备接入的域名和接口信息,请在设备接入服务的控制台上获取。 消息推送 推送协议是由应用服务器在订阅物联网平台的设备信息时设置的传输协议来确定的。应用服务器设置的订阅数据推送的传输通道为HTTP时,用户可以设置采用加密的H
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后(资源为device.status,事件为update),当物联网平台中的设备状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(PENDING状态),此时应用服务器可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
订阅后消息推送失败,例如提示503如何处理? 开发中心订阅调试时返回503: 原因可能有以下几种: 如果您是调用接口进行订阅,请从返回值判断订阅是否成功。仅当响应码为201 Created时表示调用成功,否则请根据错误码提示修改请求重新发送。 在开发中心调测时,可查看开发中心的消息跟踪,确定平台是否发送数据成功。
NB模组附着网络失败如何处理? 请先执行AT+NUESTATS,查看是否有网络信号。 若Singal power等于0,表示没有收到网络信号, 请检查基站对应的频带否放开,或把设备换个信号强的地方再尝试。 执行AT+NBAND?查询设置的频段跟模组本身的频段是不是一样的。 父主题:
信息,默认0,查询第一页,建议通过设置pageNo和pageSize做分页查询。 pageSize 可选 Integer query 分页查询参数,查询结果分页显示时每页显示的记录数,默认1,最大值2000,建议根据设备上报数据的平均大小来设置,保证单次查询返回的包大小不超过16
HTTP请求方法(也称为操作),它告诉服务你正在请求什么类型的操作。 方法 说明 POST 请求服务器新增资源或执行特殊操作。 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 DELETE 请求服务器删除指定资源,如删除对象等。 在鉴权接口的URI信息处,您可以看到其请求方法为“POST”,则其请求为:
接口说明 应用服务器在物联网平台订阅了注册设备通知后(订阅的通知类型为deviceAdded),当应用服务器通过“注册设备”接口在平台注册设备时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
对于设备上报的数据,即使创建应用时开启了存储数据能力,设备管理服务也只保存7天的历史数据。 若您希望长期保存数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平台将设备上报数据转发给对象存储服务(OBS),由OBS进行存储。 本示例为将所有设备上报的数据转发至OBS存储。
刷新token 接口说明 应用服务器通过鉴权接口获取到的accessToken是有效时间的,在accessToken快过期时,应用服务器通过调用此接口,获取新的accessToken。 URI 请求方法 POST URI /iocm/app/sec/v1.1.0/refreshToken
查询单个订阅 接口说明 应用服务器可在物联网平台上创建多个订阅,以订阅不同类型的设备变更通知。应用服务器若需要查看某个订阅的配置信息,可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId}
创建订阅 接口说明 应用服务器可调用此接口订阅物联网平台资源的变化事件,当资源发生变化时(如设备激活,设备数据更新等),平台会向应用服务器发送通知消息。 URI 请求方法 POST URI /v5/iot/{project_id}/subscriptions 传输协议 HTTPS
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令,且当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。
设备Profile文件中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令,设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设备自定义,物联网平台在接口中直接进行封装,透传。
如何理解命令下发各个状态的含义? 命令下发失败或设备收不到命令如何处理? 应用服务器调用接口失败怎么处理? 应用服务器如何获取设备上报的数据? 如何制作订阅推送调测证书? 调用订阅接口时,回调地址如何获取? 订阅后消息推送失败如何处理?
删除设备组成员 接口说明 若设备组中的一个或多个设备不再归属于该设备组,应用服务器可调用此接口从设备组删除设备成员。 URI 请求方法 POST URI /iocm/app/dm/v1.1.0/devices/deleteDevGroupTagFromDevices 传输协议 HTTPS
查询设备影子历史数据 接口说明 应用服务器通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当应用服务器需要查看设备影子的历史配置记录时,可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/shadow/v1.5.0/deviceDesiredHistory
Profile(即产品模型)是用来描述一款产品中的设备“是什么”、“能做什么”以及“如何控制该设备”的文件。在物联网平台集成对接中需要先创建Profile,因为Profile里面定义了设备上报的数据和应用服务器下发的命令包含了哪些字段。定义Profile,即在物联网平台构建一款设备的抽象
订阅平台管理数据 接口说明 应用服务器可调用此接口向物联网平台订阅设备相关的管理数据,当设备进行版本升级等相关操作时,平台会向应用服务器发送通知消息,知会其具体的操作状态或操作结果信息。 URI 请求方法 POST URI /iodm/app/sub/v1.1.0/subscribe