开启文件分享

适用版本>=v7.0.2410as.20241017
接口说明：开启分享

请求说明

请求地址	配置域名+/openapi+`/v7/drives/{drive_id}/files/{file_id}/open_link`
请求方法	POST
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	查询和管理文件分享（用户授权） `kso.file_link.readwrite` 查询和管理文件分享（应用授权） `kso.file_link.readwrite`

Header	参数类型	是否必填	说明
Content-Type	string	是	使用：`application/json`
X-Kso-Date	string	是	RFC1123 格式的日期，例: `Wed, 23 Jan 2013 06:43:08 GMT`
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：`Bearer {access_token}`

路径参数（Path）

名称	参数类型	是否必填	说明
drive_id	string	是	驱动盘id，<= 1024 characters
file_id	string	是	文件id，<= 1024 characters

请求体（Body）

名称	类型	是否必填	说明
opts	object	否	链接选项
∟ allow_perm_apply	bool	否	允许申请权限
∟ check_code	string	否	访问密码，<= 1024 characters
∟ close_after_expire	bool	否	过期后取消分享链接
∟ expire_period	int	否	过期时长，Enum: 0 7 30
∟ expire_time	int	否	过期时间点
role_id	string	是	权限角色，<= 1024 characters。支持仅查看`view_only`、可编辑`editable`、可评论`commentable`、可管理`manageable`、可分享`shareable`、禁止访问`prohibited`和自定义权限角色 (自定义权限角色请通过获取文档权限角色列表
scope	string	是	权限范围，`users`: 仅指定人；`company`:本企业内；`login_users`:本系统用户(多租户场景使用)

请求体示例

json

{
  "opts": {
    "allow_perm_apply": true,
    "check_code": "string",
    "close_after_expire": true,
    "expire_period": 0,
    "expire_time": 0
  },
  "role_id": "string",
  "scope": "company"
}

响应体（Response）

名称	类型	说明
code	int	错误码
detail	string	详细信息
msg	string	状态信息
data	object	null

响应体示例

json

{
  "data": null,
  "code": 0,
  "detail": "string",
  "msg": "string"
}