检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
在设备接入物联网平台前,应用服务器需要调用此接口在物联网平台注册设备,并设置设备的唯一标识(如IMEI)。在设备接入物联网平台时携带设备唯一标识,完成设备的接入认证。 此注册设备接口适用于使用LWM2M/CoAP协议接入的设备,或者集成了AgentLite SDK的设备。 URI 请求方法 POST URI /iocm/app/reg/v1
query 命令所属的应用ID,当创建授权应用下的命令时才需要填写。 deviceId 必选 String(64) body 下发命令的设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 command 必选 CommandDTO body 下发命令的信息。 callbackUrl
第三方应用在物联网平台订阅了设备事件通知后(订阅的通知类型为deviceEvent),当平台收到设备上报的事件消息时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备事件通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的server
址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容请参考物联网平台API参考中的消息推送章节。
URI-scheme 传输请求的协议,当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器地址,为“host:port”格式,host为服务器的访问域名或IP,port为服务器的访问端口,您可以参考平台对接信息获取应用的接入地址和端口信息。 例如设备管理
返回结果 请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,物联网平台返回的状态码如下所示。 对于鉴权接口,如果调用后返回状态码为“200”,则表示请求成功。 状态码 编码 状态码说明 200
删除指定版本包 典型场景 对于不需要继续使用和保留的设备版本包,第三方应用可调用此接口在物联网平台上删除指定的版本包。 接口功能 支持第三方应用在物联网平台根据版本包ID删除指定的版本包文件,在调用该接口前需要通过“查询版本包列表”接口查询获得要删除 接口描述 1 def del
删除指定版本包 接口说明 对于不需要继续使用和保留的设备版本包,应用服务器可调用此接口在物联网平台上删除指定的版本包,可根据版本包ID删除指定的版本包文件,在调用该接口前需要通过“查询版本包列表”接口查询获得要删除的版本包ID。 URI 请求方法 DELETE URI /iodm/northbound/v1
获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 可选 String Header 实例ID。物理多租下各实例的唯一标识,一般华为云租户无需携带该参
如果以上问题均已排除,请根据接口返回的错误码进行处理,错误码的含义可参见API参考。如果应用封装了错误码,可以使用postman调用相同的接口,获取物联网平台返回的原始错误码及描述,再按照对应错误码的处理建议进行处理。 例如调用注册设备接口提示设备已经绑定,则需要查看在自己的账号下是否已经存在相
app_key 必选 String Header 已鉴权应用的appId Authorization 必选 String Header 请求的认证信息,值为“Bearer ******”,其中******为Auth鉴权接口返回的accessToken deviceId 必选 String
rofile文件的命名自动填充,且需要和创建产品时填写的信息保持一致。 在“设备管理服务控制台”导入 登录“设备管理服务控制台”,单击左下角的切换左侧菜单,打开“产品模型”页面,点击页面右上角的“新增产品模型 > 本地导入”。 在弹窗中输入产品名称并选择要上传的Profile文件
查询设备命令撤销任务 典型场景 第三方应用创建了设备命令撤销任务后,可调用此接口查询设备命令撤销任务的详细信息和执行状态,以了解撤销任务的执行情况。 接口功能 支持第三方应用在物联网平台查询设备命令撤销任务信息和状态,可指定条件查询单个或多个撤销任务。 接口描述 1 QueryDeviceCmdCancelTaskOutDTO2
查询设备命令撤销任务 典型场景 第三方应用创建了设备命令撤销任务后,可调用此接口查询设备命令撤销任务的详细信息和执行状态,以了解撤销任务的执行情况。 接口功能 支持第三方应用在物联网平台查询设备命令撤销任务信息和状态,可指定条件查询单个或多个撤销任务。 接口描述 1 def queryDeviceCmdCancelTask(self
app_key 必选 String Header 已鉴权应用的appId Authorization 必选 String Header 请求的认证信息,值为“Bearer ******”,其中******为Auth鉴权接口返回的accessToken deviceId 必选 String
查询设备组详情 典型场景 第三方应用可调用此接口查询当前已创建的所有设备组列表信息,以了解当前设备组的分组和使用情况。 接口功能 支持第三方应用在物联网平台查询已创建的所有设备组信息。 接口描述 1 def queryDeviceGroups(self, qdgInDTO, accessToken)
header 访问物联网平台的应用ID,在物联网平台创建应用时由平台分配获得。 Authorization 必选 String header 访问物联网平台的认证信息,值为“Bearer {accessToken}”,其中{accessToken}为调用鉴权接口返回的accessToken。
serviceId 必选 String(1-64) body 命令对应的服务ID,要与profile中定义的serviceId保持一致。 method 必选 String(1-128) body 服务下具体的命令名称,要与profile中定义的命令名保持一致。 paras 可选 ObjectNode
serviceId 必选 String(1-64) body 命令对应的服务ID,要与profile中定义的serviceId保持一致。 method 必选 String(1-128) body 服务下具体的命令名称,要与profile中定义的命令名保持一致。 paras 可选 ObjectNode
第三方应用首次访问物联网平台的开放API时,需调用此接口完成接入认证;第三方应用在物联网平台的认证过期后,需调用此接口重新进行认证,才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前,完成在物联网平台的接入认证。 注意事项 鉴权接口