获取接收的分享链接列表
获取接收的分享链接列表
标签:文件分享
请求说明
| 字段 | 值 |
|---|---|
请求地址 | https://openapi.wps.cn/v7/links/recv |
HTTP 方法 | GET |
接口描述 | 获取“我收到的”分享列表 |
签名方式 | KSO-1 |
限频策略 | 无 |
权限要求 | 查询和管理文件分享(应用授权) kso.file_link.readwrite查询和管理文件分享(用户授权) kso.file_link.readwrite |
请求头 (Headers)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|---|---|---|---|---|
X-Kso-Id-Type | string | 否 | 类型 * internal - 内部 * external - 外部 | internal, external |
查询参数 (Query)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|---|---|---|---|---|
with_permission | boolean | 否 | 是否返回文件操作权限 | - |
page_size | integer | 是 | 分页大小,公网限制最大为500 | - |
page_token | string | 否 | 翻页token | - |
order_by | object | 否 | 排序字段,默认为mtime, 没有dtime | - |
order | object | 否 | 排序方式,默认为desc | - |
响应体(Response)
HTTP状态码: 200
响应体格式: application/json
没有可用的数据
响应体示例
json
{
"data": {
"items": [
{
"file": {
"created_by": {
"avatar": "string",
"company_id": "string",
"id": "string",
"name": "string",
"type": "user"
},
"ctime": 0,
"drive": {
"allotee_id": "string",
"allotee_type": "user",
"company_id": "string",
"created_by": {
"avatar": "string",
"company_id": "string",
"id": "string",
"name": "string",
"type": "user"
},
"ctime": 0,
"description": "string",
"ext_attrs": [
{
"name": "string",
"value": "string"
}
],
"id": "string",
"mtime": 0,
"name": "string",
"quota": {
"deleted": 0,
"remaining": 0,
"total": 0,
"used": 0
},
"source": "string",
"status": "inuse"
},
"drive_id": "string",
"ext_attrs": [
{
"name": "string",
"value": "string"
}
],
"id": "string",
"link_id": "string",
"link_url": "string",
"modified_by": {
"avatar": "string",
"company_id": "string",
"id": "string",
"name": "string",
"type": "user"
},
"mtime": 0,
"name": "string",
"parent_id": "string",
"permission": {
"comment": true,
"copy": true,
"copy_content": true,
"delete": true,
"download": true,
"history": true,
"list": true,
"move": true,
"new_empty": true,
"perm_ctl": true,
"preview": true,
"print": true,
"rename": true,
"saveas": true,
"secret": true,
"share": true,
"update": true,
"upload": true
},
"shared": true,
"size": 0,
"type": "folder",
"version": 0
},
"recv_time": 0
}
],
"next_page_token": "string"
},
"code": 0,
"msg": "string"
}