更新时间:2024-07-01 GMT+08:00
分享

查询版本包列表

典型场景

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

接口功能

支持第三方应用在物联网平台查询已上传的版本包列表信息,可根据条件查询满足要求的版本包。

接口描述

1
QueryUpgradePackageListOutDTO queryUpgradePackageList(QueryUpgradePackageListInDTO quplInDTO, String accessToken) throws NorthApiException

参数说明

参数

必选/可选

类型

位置

描述

quplInDTO

必选

QueryUpgradePackageListInDTO

query

见下表QueryUpgradePackageListInDTO的描述。

accessToken

必选

String

header

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

QueryUpgradePackageListInDTO

参数

必选/可选

类型

位置

描述

fileType

可选

String(256)

query

版本包类型。

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

deviceType

可选

String(256)

query

版本包适用的设备类型。

model

可选

String(256)

query

版本包适用的设备型号。

manufacturerName

可选

String(256)

query

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

version

可选

String(256)

query

版本包的版本号。

pageNo

可选

Integer

query

分页查询参数,默认值0。

  • 值为空时,查询内容不分页。
  • 值为大于等于0的整数时,分页查询。
  • 值为0时查询第一页。

pageSize

可选

Integer

query

查询结果分页时的每页结果数量,取值范围1-100,默认值10。

响应参数

QueryUpgradePackageListOutDTO

参数

类型

描述

data

List< QueryUpgradePackageOutDTO>

版本包列表信息,具体参见QueryUpgradePackageOutDTO结构体。

pageNo

Integer

查询结果的页码。

pageSize

Integer

查询结果每页的记录数量。

totalCount

Integer

查询结果的总记录数。

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.

请求错误。

处理建议:请检查接口请求中pageNo和pageSize的值是否在正常范围内。

400

123029

pageNo or pageSize beyond the limit.

pageNo或pageSize超出上限。

处理建议:修改pageNo或pageSize为合法取值。

403

1010009

app throttle exceed.

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

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

403

1010005

Invalid access token or appId.

错误的token信息。

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

相关文档