更新时间:2022-02-24 GMT+08:00

查询指定版本包

典型场景

在进行设备版本升级前,第三方应用可调用此接口在物联网平台查询某个版本升级包的信息,确保设备要升级的版本包已上传到平台。

接口功能

支持第三方应用在物联网平台根据版本包ID查询指定版本包信息,在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。

接口描述

1
QueryUpgradePackageOutDTO queryUpgradePackage(String fileId, String accessToken) throws NorthApiException

参数说明

参数

必选/可选

类型

位置

描述

fileId

必选

String

path

版本包ID,在上传版本包后获得。

accessToken

必选

String

header

如果调用了定时刷新token接口,此参数值可以填写null,否则要填写鉴权接口获取的accessToken。

响应参数

QueryUpgradePackageOutDTO

参数

类型

描述

fileId

String

版本包ID。

name

String

版本包名称。

version

String

版本包的版本号。

fileType

String

版本包类型。

  • firmwarePackage:固件包
  • softwarePackage:软件包

deviceType

String

版本包适用的设备类型。

model

String

版本包适用的设备型号。

manufacturerName

String

版本包适用的设备厂商名称。

protocolType

String

版本包适用的设备协议类型。

description

String

版本包的描述信息。

date

String

版本包的生成时间。

uploadTime

String

版本包的上传日期。

错误码

Http状态码

错误码

错误描述

说明

400

120015

Bad request error.

请求错误。

处理建议:请检查接口请求中fileId的格式是否正确。

403

1010009

app throttle exceed.

应用调用接口过于频繁,超过流控值(默认值是100次/60s)。

处理建议:联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。

403

1010005

App_key or access_token is invalid.

错误的token信息。

处理建议:请检查接口请求中所携带的accessToken是否有误。

404

123002

Device or package file not found.

设备或包不存在。

处理建议:请检查接口请求中的fileId是否正确。