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

查询版本包列表

典型场景

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

接口功能

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

接口描述

1
public function queryUpgradePackageList($quplInDTO, $accessToken)

参数说明

参数

必选/可选

位置

描述

$quplInDTO

必选

query

见下表QueryUpgradePackageListInDTO的描述。

$accessToken

必选

header

填写鉴权接口获取的accessToken。

QueryUpgradePackageListInDTO

参数

必选/可选

位置

描述

$fileType

可选

query

版本包类型。

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

$deviceType

可选

query

版本包适用的设备类型。

$model

可选

query

版本包适用的设备型号。

$manufacturerName

可选

query

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

$version

可选

query

版本包的版本号。

$pageNo

可选

query

分页查询参数,默认值“0”

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

$pageSize

可选

query

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

响应参数

QueryUpgradePackageListOutDTO

参数

描述

$data

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

$pageNo

查询结果的页码。

$pageSize

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

$totalCount

查询结果的总记录数。

QueryUpgradePackageOutDTO结构体说明:

参数

描述

$fileId

版本包ID。

$name

版本包名称。

$version

版本包版本号。

$fileType

版本包文件类型。

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

$deviceType

版本包适用的设备类型。

$model

版本包适用的设备型号。

$manufacturerName

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

$protocolType

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

$description

版本包的描述信息。

$date

版本包的生成时间。

$uploadTime

版本包的上传日期。

错误码

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

App_key or access_token is invalid.

错误的token信息。

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