功能描述
用于查看历史版本列表。
请求
请求示例
GET /api/v1/directory-history/
{LibraryId}
/{SpaceId}
/history-list/{DirPath}
?page={Page}
&page_size={PageSize}
&order_by={OrderBy}
&order_by_type={OrderByType}
&access_token={AccessToken}
请求参数:
LibraryId:媒体库 ID,必选参数。
SpaceId:空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(
-
);如果媒体库为多租户模式,则必须指定该参数。Page:分页码,默认第一页,可选参数。
PageSize:分页大小,默认 20,可选参数。
OrderBy:排序字段,按文件大小排序为 size,按创建时间排序为 creationTime,可选参数。
OrderByType:排序方式,升序为 asc,降序为 desc,可选参数。
AccessToken:访问令牌,必选参数。
请求体
该请求无请求体。
响应
响应码
获取成功,返回 HTTP 200 OK。
响应体
application/json
响应体示例:
{"totalNum": 1,"contents": [{"id":1,"createdBy":123,"creationWay":1,"version":2,"isLatestVersion":true,"name": "yhltest","size":"2345","crc64": "-4750849857331804891","creationTime": "2021-08-12T08:13:55.000Z","setLatestTime": "2021-08-12T08:13:55.000Z"}]}
响应体字段说明:
totalNum:整数,当前目录中的所有文件和子目录数量(不包含孙子级)。
contents:对象数组,目录或相簿内的具体内容:
id 历史版本 ID。
createdBy 创建人 ID。
creationWay 创建方式,0:创建,1:更新;2:恢复。
version:整型,版本号。
isLatestVersion:布尔型,是否最新版本。
name:字符串,目录或相簿名或文件名。
size:历史版本文件大小。
crc64:文件的 CRC64-ECMA182 校验值,为了避免数字精度问题,这里为字符串格式。
creationTime:ISO 8601格式的日期与时间字符串,表示目录或相簿的创建时间或文件的上传时间,例如
2020-10-14T10:17:57.953Z
。setLatestTime:设置为最新版的时间。