根据文件 ID 查询文件信息

最近更新时间:2025-10-24 15:25:22

我的收藏

功能描述

根据文件 ID 查询文件信息。

请求

请求示例

GET /api/v1/inode/`{LibraryId}`/`{SpaceId}`/`{INode}`?access_token=`{AccessToken}`

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
INode
文件 ID,获取请参见 查看文件详情
String
AccessToken
访问令牌,对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数获取请参见 生成访问令牌
String

请求体

响应

响应码

获取成功,返回 HTTP 200 OK。

响应体

application/json
响应体示例:
{
"path": [ "folderA", "1.jpg" ],
"name": "1.jpg",
"type": "file",
"creationTime": "2020-09-22T07:44:45.000Z",
"modificationTime": "2020-09-22T07:44:45.000Z",
"contentType": "image/png",
"size": "1048576",
"crc64": "123"
}
响应体字段说明:
响应参数
描述
类型
path
文件目录路径
String Array
name
文件目录名称
String
type
文件目录类型:
dir: 目录或相簿;
file: 文件,仅用于文件类型媒体库
String
creationTime
文件目录创建时间
String
modificationTime
文件最近一次被覆盖的时间,或者目录内最近一次增删子目录或文件的时间
String
contentType
媒体类型(仅非目录或相簿返回)
String
crc64
文件的 CRC64-ECMA182 校验值,为了避免数字精度问题,这里为字符串格式(仅非目录或相簿返回)
String
size
文件目录大小(仅非目录或相簿返回)
String

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。