简要描述：

  • 查询资源文件详情接口

接口版本：

版本号 制定人 制定日期 修订日期
1.1.0 李晋 2023-04-23 2023-04-23

请求URL:

iot-platform/resource-file-server/v1/file/detail

请求方式：

  • GET

请求头：

参数名 是否必须 类型 说明
Content-Type 是 string 请求类型： application/json
Authorization 是 string 请求token

请求参数:

参数名 是否必须 类型 说明
fileId 是 long 文件id
version 否 int 文件当前版本号, 传值：检查最新版本号是否比当前版本号大，如果是返回最新版本数据，否则不返回数据；不传值：返回最新版本数据

返回示例:

正确时返回:

{
    "code": 0,
    "msg": "ok",
    "err_code": 10000,
    "result": {
        "fileId": 1648266973047357440,
        "fileName": "xx",
        "fileSize": 111,
        "version": 1,
        "state": 1,
        "url": "https://narwal-test-public.oss-cn-shenzhen.aliyuncs.com/default/1681812444392/2.png",
        "signature": "d44916eb12ee3f24aa52961ed037c84c",
        "labelList": [{
            "labelKey":"k1",
            "labelValue":"v1"
        }]
    }
}

错误时返回:

{
    "code": -1,
    "msg": "参数错误",
    "err_code": -1
}

返回参数说明:

参数名 类型 是否必须 说明
code int 是 状态码，0：调用成功，非0：调用失败
msg string 是 错误提示信息
err_code int 是 错误码，当code为0时返回10000，否则返回对应错误码
result object 否 返回具体数据

result字段说明：

参数名 类型 是否必须 说明
fileId long 是 文件id
fileName string 是 文件名称
fileSize long 是 文件大小，单位kb
version int 是 文件版本号
url string 是 文件url
signature string 是 文件签名
state int 是 文件状态 1：有效，2：无效
labelList array 是 文件标签列表，无标签时为空数组

labelList字段说明:

参数名 类型 是否必须 说明
labelKey string 是 标签key
labelValue string 是 标签value

备注:

  • 更多返回错误代码请看首页的错误代码描述
 创建时间：2023-04-24 11:24
最后编辑：陈勇琦  更新时间：2025-04-29 15:30