检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备影子 典型场景 若设备处于离线或异常状态时,第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方
注册设备(验证码方式) 典型场景 在设备接入物联网平台前,第三方应用需要调用此接口在物联网平台注册设备,并把设备的唯一标识码(如IMEI)设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识,完成设备的接入认证。 接口功能 支持第三方应用在物联网平台注册设备,完成注册后设备方可接入物联网平台。
设备登录 接口功能 设备在第一次绑定后,或者在设备重启后需要进行登录的流程。 接口描述 1 HW_INT IOTA_Login(); 接口返回值 参见函数标准返回值 此返回值是调用接口的同步返回结果,返回0只是说明接口调用成功,并不说明登录成功,登录成功需要收到IOTA_TOP
添加设备 接口功能 当有新设备接入网关后,通过调用设备添加接口将非直连设备接入物联网平台,并且获得平台分配的唯一设备逻辑ID。 接口描述 1 HW_INT IOTA_HubDeviceAdd(HW_UINT uiCookie, const ST_IOTA_DEVICE_INFO *pstDeviceInfo);
查询设备影子 典型场景 若设备处于离线或异常状态时,第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方
注册设备(验证码方式) 典型场景 在设备接入物联网平台前,第三方应用需要调用此接口在物联网平台注册设备,并把设备的唯一标识码(如IMEI)设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识,完成设备的接入认证。 接口功能 支持第三方应用在物联网平台注册设备,完成注册后设备方可接入物联网平台。
修改设备命令 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台。
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(DEFAULT状态),此时第三方应用可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(DEFAULT状态),此时第三方应用可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令
设备响应命令 接口说明 设备对物联网平台控制命令的应答。 应用服务器要需要调用“订阅平台业务数据”API订阅“commandRsp”类型的通知后,才能接收到设备对控制命令的应答。 Topic Topic /huawei/v1/devices/{deviceId}/data/{codecMode}
删除设备 典型场景 已在物联网平台注册的设备,若不再需要接入平台时,第三方应用可调用此接口在物联网平台删除设备。后续若设备要再次接入平台,第三方应用需要在物联网平台重新注册设备。 接口功能 支持第三方应用在物联网平台删除已注册的设备,使设备无法再接入平台。 接口描述 1 void
鉴权 典型场景 第三方应用首次访问物联网平台的开放API时,需调用此接口完成接入认证;第三方应用在物联网平台的认证过期后,需调用此接口重新进行认证,才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前,完成在物联网平台的接入认证。 注意事项
删除设备 典型场景 已在物联网平台注册的设备,若不再需要接入平台时,第三方应用可调用此接口在物联网平台删除设备。后续若设备要再次接入平台,第三方应用需要在物联网平台重新注册设备。 接口功能 支持第三方应用在物联网平台删除已注册的设备,使设备无法再接入平台。 接口描述 1 def
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:
修改设备命令 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,第三方应用通过调用此接口,获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken。
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,第三方应用通过调用此接口,获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken。
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台。