检查目录或相簿

最近更新时间:2026-01-05 17:21:12

我的收藏

功能描述

用于检查目录或相簿状态。

请求

请求示例

HEAD /api/v1/directory/`{LibraryId}`/`{SpaceId}`/`{DirPath}`?access_token=`{AccessToken}`&user_id=`{UserId}`

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则为具体 ID,获取请参见 创建租户空间
String
DirPath
目录路径或相簿名,对于多级目录,使用斜杠(/)分隔,例如 foo/bar;对于根目录,该参数留空
String
AccessToken
访问令牌,对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数,获取请参见 生成访问令牌
String
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参见 生成访问令牌接口
String

请求体

该请求无请求体。

响应

响应码

目录或相簿存在,返回 HTTP 200 OK。
目录或相簿不存在,返回 HTTP 404 Not Found。

响应体

该响应无响应体。

错误码

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