资源工坊

获取”我收到的“分享列表 ​

适用版本>=v7.0.2312a.20231207

接口说明：获取我收到的分享列表

请求说明 ​

请求地址配置域名+/graph+/v7/links/recv
请求方法GET
签名方式WPS-4签名/WPS-4-GM签名（配置域名+/graph不参与签名）
权限要求管理文件分享（用户授权） kso.file.share.write

请求头（Header） ​

名称是否必填说明
Content-Type是固定为: application/json
Wps-Docs-Date是取当前时间， 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization是计算方法参考签名说明
Authorization是授权凭证，格式为: Bearer {access_token}

查询参数（Query） ​

名称参数类型是否必填说明
with_permissionbool否是否返回文件操作权限
page_sizeint是请求大小，最大值：1024
page_tokenstring否分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回next_page_token作为新的page_token，下次遍历可采用该page_token获取查询结果

响应体（Response） ​

| 名称 | 类型 | 说明 | | :--------------------------------- | :------: | :------------------------------------------------------------------------------------------------ | --- | | code | integer | 错误码 | | detail | string | 详细信息 | | msg | string | 状态信息 | | data | object | 文件存储的介质 | | ∟ items | object[] | 数据集合，<= 1024 items | | ∟ ∟ file | object | 文件属性 | | ∟ ∟ ∟ id | string | 文件id | | ∟ ∟ ∟ drive_id | string | 驱动盘id | | ∟ ∟ ∟ parent_id | string | 父文件id | | ∟ ∟ ∟ created_by | object | 创建者信息 | | ∟ ∟ ∟ ∟ avatar | string | 创建者头像，<= 1024 characters | | ∟ ∟ ∟ ∟ company_id | string | 创建者企业id，<= 1024 characters | | ∟ ∟ ∟ ∟ id | string | 创建者id，<= 1024 characters | | ∟ ∟ ∟ ∟ name | string | 创建者名称，<= 1024 characters | | ∟ ∟ ∟ ∟ type | string | 创建者身份类型，user：用户 | | | ∟ ∟ ∟ modified_by | object | 修改者信息 | | ∟ ∟ ∟ ∟ avatar | string | 修改者头像，<= 1024 characters | | ∟ ∟ ∟ ∟ company_id | string | 修改者企业id，<= 1024 characters | | ∟ ∟ ∟ ∟ id | string | 修改者id，<= 1024 characters | | ∟ ∟ ∟ ∟ name | string | 修改者名称，<= 1024 characters | | ∟ ∟ ∟ ∟ type | string | 修改者身份类型，user：用户 | | ∟ ∟ ∟ size | int64 | 文件大小 | | ∟ ∟ ∟ version | int | 文件版本 | | ∟ ∟ ∟ type | string | 文件类型 | | ∟ ∟ ∟ name | string | 文件名称 | | ∟ ∟ ∟ ctime | int64 | 文件创建时间，时间戳，单位为秒 | | ∟ ∟ ∟ mtime | int64 | 文件修改时间，时间戳，单位为秒 | | ∟ ∟ ∟ hash | object | 文件哈希信息 | | ∟ ∟ ∟ ∟ sum | string | 哈希结果，<= 1024 characters | | ∟ ∟ ∟ ∟ type | string | 哈希类型，固定为s2s | | ∟ ∟ ∟ ext_attrs | object[] | 文件扩展属性 | | ∟ ∟ ∟ permission | object | 文件权限 | | ∟ ∟ ∟ link_url | string | 分享链接 | | ∟ ∟ ∟ link_id | string | 分享链接id | | ∟ ∟ file_src | object | 文件来源 | | ∟ ∟ ∟ name | string | 来源名称，<= 1024 characters | | ∟ ∟ ∟ type | string | 来源类型，Enum: "link" "user_private" "user_roaming" "group_normal" "group_dept" "group_whole" | | ∟ ∟ hash | object | 哈希 | | ∟ ∟ ∟ sum | string | 哈希结果，<= 1024 characters | | ∟ ∟ ∟ type | string | 哈希类型，固定为s2s | | ∟ ∟ recv_time | int | 接收时间 | | ∟ next_page_token | string | 下一页分页标记，<= 1024 characters；当查询结果中next_page_token为空或无该返回值时，代表无下一页。 |

响应体示例 ​

{
  "data": {
    "items": [
      {
        "file": {
          "created_by": {
            "avatar": "string",
            "company_id": "string",
            "id": "string",
            "name": "string",
            "type": "user"
          }，
          "ctime": 0,
          "drive_id": "string",
          "ext_attrs": [
            {
              "name": "string",
              "value": "string"
            }
          ]，
          "hash": {
            "sum": "string",
            "type": "s2s"
          }，
          "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,
            "list": true,
            "move": true,
            "new_empty": true,
            "perm_ctl": true,
            "preview": true,
            "print": true,
            "rename": true,
            "share": true,
            "update": true,
            "upload": true
          }，
          "size": 0,
          "type": "folder",
          "version": 0
        }，
        "recv_time": 0
      }
    ]，
    "next_page_token": "string"
  }，
  "code": 0,
  "detail": "string",
  "msg": "string"
}