功能描述
用于创建租户空间。需要主账号权限。
说明
非 acl 鉴权是指当前用户对所有文件的操作权限,详情可参见 生成访问令牌接口。
acl 鉴权是通过共享授权接口给指定用户,以文件夹为单位授予的权限,详情可参见 角色授权模块。
仅限在开启多租户模式的媒体库中使用该接口。
媒体托管暂不提供租户空间名属性,如业务有相关需要,可自行保存空间 ID 与空间名的映射。
创建租户空间时可在请求体中以 JSON 格式指定扩展属性。
请求
请求示例
POST /api/v1/space/`{LibraryId}`?access_token=`{AccessToken}`&user_id=`{UserId}`
请求参数
请求参数 | 描述 | 是否必选 |
LibraryId | 媒体库 ID | 是 |
AccessToken | 访问令牌 | 是 |
UserId | 否 |
请求体
空或 application/json,可指定租户空间的扩展属性。
{"isPublicRead": false,"isMultiAlbum": true,"allowPhoto": true,"allowVideo": true,"allowPhotoExtname": [ ".jpg", ".png", ".heic" ],"allowVideoExtname": [ ".mp4", ".mov" ],"recognizeSensitiveContent": true,"spaceTag": "team"}
请求体字段说明:
请求参数 | 描述 | 是否必选 |
isPublicRead | 布尔型,是否为公有读,不指定默认为 false,当租户空间设置为公有读时,部分读接口无需指定访问令牌,请参阅具体的 API 说明,该参数可随时修改。 | 否 |
isMultiAlbum | 布尔型,是否为多相簿空间,不指定默认为 false,此时租户空间不允许创建目录或相簿,该参数仅允许在创建租户空间时指定,后续无法修改。 | 否 |
allowPhoto | 布尔型,是否允许上传照片,不指定默认为 false,该参数可随时修改。 | 否 |
allowVideo | 布尔型,是否允许上传视频,不指定默认为 false,该参数可随时修改。 | 否 |
allowPhotoExtname | 字符串数组,默认为空数组,当该参数不为空数组时,仅当上传的文件扩展名存在于该列表中才允许上传且认定为照片,当该参数为空数组时则根据上传的文件扩展名动态判断是否为照片类型,该参数可随时修改。 | 否 |
allowVideoExtname | 字符串数组,默认为空数组,当该参数不为空数组时,仅当上传的文件扩展名存在于该列表中才允许上传且认定为视频,当该参数为空数组时则根据上传的文件扩展名动态判断是否为视频类型,该参数可随时修改。 | 否 |
recognizeSensitiveContent | 布尔型,是否检测敏感内容,不指定默认为 false。 | 否 |
spaceTag | 字符串,空间标识,用于区分个人空间和团队空间。 | 否 |
响应
响应码
获取成功,返回 HTTP 201 Created。
响应体
{ "spaceId": "spacexxx" }
响应体字段说明:
节点名称(关键字) | 描述 |
spaceId | 字符串,新创建的租户空间的空间 ID。 |