设备接入 IoTDA设备接入 IoTDA

更新时间:2021/09/06 GMT+08:00
分享

查询指定版本包

接口说明

在进行设备版本升级前,应用服务器可调用此接口在物联网平台查询某个版本升级包的信息,确保设备要升级的版本包已上传到平台,可根据版本包ID查询指定版本包信息,在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。

URI

请求方法

GET

URI

/iodm/northbound/v1.5.0/category/{fileId}

传输协议

HTTPS

请求参数

参数

必选/可选

类型

位置

描述

app_key

必选

String

header

访问物联网平台的应用ID,在物联网平台创建应用时由平台分配获得。

Authorization

必选

String

header

访问物联网平台的认证信息,值为“Bearer {accessToken}”,其中{accessToken}为调用鉴权接口返回的accessToken。

fileId

必选

String

path

版本包ID,通过“查询版本包列表”接口查询获得。

响应参数

Status Code: 200 OK

参数

类型

描述

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

版本包上传的UTC时间,时间格式:yyyyMMdd'T'HHmmss'Z',如20151212T121212Z。

若需要显示本地时区时间,您需要自己进行时间转换。

请求示例

GET https://{host}:{port}/iodm/northbound/v1.5.0/category/{fileId}
Content-Type: application/json
app_key: ******
Authorization: Bearer ******

正常响应示例

Status Code: 200 OK
Content-Type: application/json

{
  "fileId": "**********",
  "name": "******",
  "version": "V1.1.10",
  "fileType": "softwarePackage",
  "deviceType": "******",
  "model": "******",
  "manufacturerName": "***",
  "protocolType": "CoAP",
  "description": "Test software package made by WYH",
  "date": "2015-2-2 ",
  "uploadTime": "20151212T121212Z"
}

错误码

Http状态码

错误码

错误描述

说明

400

120015

Bad request error.

请求错误。

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

403

1010009

app throttle exceed.

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

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

403

1010005

Invalid access token or appId.

错误的token信息。

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

404

123002

Device or package file not found.

设备或包不存在。

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

分享:

    相关文档

    相关产品