功能描述
用于检查文件状态。
请求
请求示例
HEAD /api/v1/file/
{LibraryId}
/{SpaceId}
/{FilePath}
?access_token={AccessToken}
&history_id={HistoryId}
&user_id={UserId}
请求参数:
LibraryId:媒体库 ID,必选参数。
SpaceId:空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(
-
);如果媒体库为多租户模式,则必须指定该参数。HistoryId:历史版本 ID,用于获取不同版本的文件内容,可选参数,不传默认为最新版。
FilePath:完整文件路径,例如
foo/bar/file.docx
。AccessToken:访问令牌,对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数。
UserId:用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参阅 生成访问令牌接口,可选参数。
请求体
该请求无请求体。
响应
响应码
文件存在,返回 HTTP 200 OK;文件不存在,返回 HTTP 404 Not Found。
响应头部
文件存在
x-smh-type:文件类型。
x-smh-creation-time:文件完成上传的时间。
x-smh-content-type:媒体类型。
x-smh-size:文件大小。
x-smh-etag:文件 ETag。
x-smh-crc64:文件的 CRC64-ECMA182 校验值,为了避免数字精度问题,这里为字符串格式。
x-smh-meta-*:自定义元数据。
响应体
该接口无响应体。