获取分享链接信息
根据 link_id 获取分享链接信息
请求说明
| 请求地址 | https://openapi.wps.cn/v7/links/{link_id}/meta |
|---|---|
| 请求方法 | GET |
| 签名方式 | KSO-1 |
| 权限要求 | 查询和管理文件分享（用户授权） kso.file_link.readwrite查询和管理文件分享（应用授权） kso.file_link.readwrite |
请求头（Header）
| 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）
| 名称 | 参数类型 | 说明 |
|---|---|---|
| link_id | string | 链接 id |
请求地址示例
[GET] https://openapi.wps.cn/v7/links/{link_id}/meta响应体
| 名称 | 参数类型 | 说明 |
|---|---|---|
| code | integer | 响应代码。非 0 表示失败，参照《状态码说明》 |
| msg | string | 响应信息 |
| data | object | 响应数据 |
| ∟ created_by | object | 创建者身份 |
| ∟ ∟ avatar | string | 创建者的头像 |
| ∟ ∟ company_id | string | 创建者的企业 id |
| ∟ ∟ id | string | 创建者的 id |
| ∟ ∟ name | string | 创建者的名称 |
| ∟ ∟ type | string[enum] | 身份类型 user：用户；sp：服务主体 |
| ∟ ctime | integer | 创建时间 |
| ∟ drive_id | string | 盘 id |
| ∟ file_id | string | 文件 id |
| ∟ id | string | 分享 id |
| ∟ mtime | integer | 修改时间 |
| ∟ opts | object | 链接设置 |
| ∟ ∟ allow_perm_apply | boolean | 允许申请权限 |
| ∟ ∟ check_code | string | 访问密码 |
| ∟ ∟ close_after_expire | boolean | 过期后取消分享链接 |
| ∟ ∟ expire_period | integer[enum] | 过期时长 0 7 30 |
| ∟ ∟ expire_time | integer | 过期时间点 |
| ∟ role_id | string | 链接权限角色 id |
| ∟ scope | string[enum] | 链接权限范围 anyone：所有人；company：企业；users：用户 |
| ∟ status | string[enum] | 链接状态 open：开启；closed：关闭；expired：过期 |
| ∟ url | string | 分享访问 url |
| more | object | 更多的错误信息 |
响应体示例
json
{
"data": {
"created_by": {
"avatar": "string",
"company_id": "string",
"id": "string",
"name": "string",
"type": "string[enum]"
},
"ctime": 0,
"drive_id": "string",
"file_id": "string",
"id": "string",
"mtime": 0,
"opts": {
"allow_perm_apply": false,
"check_code": "string",
"close_after_expire": false,
"expire_period": 0,
"expire_time": 0
},
"role_id": "string",
"scope": "string[enum]",
"status": "string[enum]",
"url": "string"
},
"msg": "string",
"code": 0
}