产品概述
功能介绍
产品优势
应用场景
基本概念
GET /api/v1/token?library_id=`{LibraryId}`&library_secret=`{LibrarySecret}`&space_id=`{SpaceId}`&user_id=`{UserId}`&client_id=`{ClientId}`&session_id=`{SessionId}`&period=`{Period}`&grant=`{Grant}`
POST /api/v1/token?library_id=`{LibraryId}`&library_secret=`{LibrarySecret}`&space_id=`{SpaceId}`&user_id=`{UserId}`&client_id=`{ClientId}`&period=`{Period}`&grant=`{Grant}`
/api/v1/token?library_id=smhxxx&library_secret=1234abcd&space_id=spacexxx&user_id=ABCD1234&grant=upload_file,create_directory,下同。请求参数 | 描述 | 类型 | 是否必选 |
LibraryId | String | 是 | |
LibrarySecret | String | 是 | |
SpaceId | 空间 ID,可同时指定多个空间 ID,使用英文逗号(,)分隔 | String | 如果媒体库为单租户模式,则无需指定该参数 如果媒体库为多租户模式,当需要操作租户空间时,无需指定该参数。当进行其他操作时,若授予管理员权限则该参数为可选,否则必须指定该参数 |
UserId | 用户身份识别,由业务后台自行控制 | String | 否 |
ClientId | 客户端识别,由业务后台自行控制 | String | 否 |
SessionId | SessionId,由业务后台自行控制 | String | 否 |
Period | 令牌有效时长及每次使用令牌后自动续期的有效时长,可选参数,单位为秒,有效值为正整数,传入其他值将使用默认值 86400(24小时),传入小于 300 的值将自动使用最小值 300(5 分钟),传入大于 315360000 的值将自动使用最大值 315360000(10 年) | String | 否 |
Grant | 授予的权限,如为空则只授予读取权限,可指定此参数在只读基础上同时附加下述多个权限项,并使用英文逗号(,)分隔,例如: create_directory,upload_file | String | 否 |
权限项 | 描述 |
admin | 管理员权限,授予所有权限 |
create_space | 拥有创建租户空间权限 |
delete_space | 拥有删除租户空间权限 |
space_admin | 租户空间管理员权限,拥有除租户空间操作以外的所有权限 |
create_directory | 拥有创建目录或相簿权限 |
delete_directory | 拥有删除目录或相簿权限(未开启回收站)/将目录或相簿移入回收站权限(开启回收站) |
delete_directory_permanent | 开启回收站时,拥有永久删除目录或相簿权限 |
move_directory | 拥有重命名或移动目录或相簿权限 |
copy_directory | 拥有复制目录或相簿权限 |
upload_file | 拥有上传文件权限,但不允许覆盖已有文件 |
upload_file_force | 拥有上传文件权限,且允许覆盖已有文件 |
begin_upload | 拥有开始上传文件权限,但不允许覆盖已有文件 |
begin_upload_force | 拥有开始上传文件权限,且允许覆盖已有文件 |
confirm_upload | 拥有完成上传文件权限;将开始上传与完成上传权限分离,主要用于业务前后端权限的分离,使完成上传必须经过业务后端;如果同时需要开始上传和完成上传权限,可简单指定 upload_file 或 upload_file_force |
create_symlink | 拥有创建符号链接权限,但不允许覆盖已有文件或符号链接 |
create_symlink_force | 拥有创建符号链接权限,且允许覆盖已有文件或符号链接 |
delete_file | 拥有删除文件权限(未开启回收站)/将文件移入回收站权限(开启回收站) |
delete_file_permanent | 开启回收站时,拥有永久删除文件权限 |
move_file | 拥有重命名或移动文件权限,但不允许覆盖已有文件 |
move_file_force | 拥有重命名或移动文件权限,且允许覆盖已有文件 |
copy_file | 拥有复制文件权限,但不允许覆盖已有文件 |
copy_file_force | 拥有复制文件权限,且允许覆盖已有文件 |
delete_recycled | 拥有删除回收站项目权限 |
restore_recycled | 拥有恢复回收站项目权限 |
set_history_latest | 拥有将某个历史版本设置为最新版本权限 |
delete_history | 拥有删除历史版本权限 |
{"attachInfo": {"operatorPhoneNumber": "18628769878"}}
节点名称(关键字) | 描述 | 类型 | 是否可选 |
attachInfo | 触发信息,JSON 对象,用于记录日志 | Json | 否 |
{"accessToken": "acctk01f7af4f07me88u2svxwp9tszuekqlprquuejxxxxxx","expiresIn": 86400}
节点名称(关键字) | 描述 | 类型 |
accessToken | 访问令牌的具体值 | String |
expiresIn | 访问令牌的有效时长,单位为秒 | Int |
文档反馈