资源工坊

获取团队文档库列表 ​

适用版本>=v7.0.2501a.20250116

接口说明：获取文档库（团队文档）列表

请求说明 ​

请求地址配置域名+/openapi+/v7/doclibs
请求方法GET
签名方式KSO-1（配置域名+/openapi不参与签名）
权限要求查询和管理文档库（用户授权） kso.doclib.readwrite
查询和管理文档库（应用授权） kso.doclib.readwrite

请求头（Header） ​

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

查询参数（Query） ​

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

响应体（Response） ​

名称类型说明
codeint错误码
detailstring详细信息
msgstring状态信息
dataobject获取团队文档库列表响应体
∟ itemsobject[]文档库列表,<= 1024 items
∟ ∟ driveobject文档库驱动盘信息
∟ ∟ ∟ allotee_idstring盘归属身份id
allotee_type=user，allotee_id代表用户id；
allotee_type=group，allotee_id代表用户组id
∟ ∟ ∟ allotee_typestring盘归属身份类型，可选值：
user：用户
group:用户组
∟ ∟ ∟ company_idstring企业id,<= 1024 characters
∟ ∟ ∟ created_byobject创建者
∟ ∟ ∟ ∟ avatarstring创建者头像，<= 1024 characters
∟ ∟ ∟ ∟ company_idstring创建者企业id，<= 1024 characters
∟ ∟ ∟ ∟ idstring创建者id，<= 1024 characters
∟ ∟ ∟ ∟ namestring创建者名称，<= 1024 characters
∟ ∟ ∟ ∟ typestring创建者身份类型，user：用户
∟ ∟ ∟ ctimeint创建时间，时间戳，单位为秒
∟ ∟ ∟ descriptionstring盘描述,<= 1024 characters
∟ ∟ ∟ ext_attrsobject[]盘扩展属性,<= 1024 items
∟ ∟ ∟ ∟ namestring属性名,<= 1024 characters
∟ ∟ ∟ ∟ valuestring属性值,<= 1024 characters
∟ ∟ ∟ idstring驱动盘id,<= 1024 characters
∟ ∟ ∟ mtimeint修改时间，时间戳，单位为秒
∟ ∟ ∟ namestring驱动盘名称
∟ ∟ ∟ quotaobject盘容量
∟ ∟ ∟ ∟ deletedint回收站中的文件占用的总空间,以字节为单位。只读。
∟ ∟ ∟ ∟ remainingint剩余的总空间,以字节为单位。只读。
∟ ∟ ∟ ∟ totalint允许的总存储空间,以字节为单位。只读。
∟ ∟ ∟ ∟ usedint已使用的总空间,以字节为单位。只读。
∟ ∟ ∟ statusstring盘状态
inuse:使用中;deleted:已删除;
∟ ∟ groupobject文档库用户组信息
∟ ∟ ∟ avatarstring头像
∟ ∟ ∟ creator_idstring创建者ID 创建时即确定,不被修改。
∟ ∟ ∟ ctimeint创建时间，时间戳，单位为秒
∟ ∟ ∟ descriptionstring描述介绍
∟ ∟ ∟ idstring组ID
∟ ∟ ∟ mtimeint修改时间，时间戳，单位为秒
∟ ∟ ∟ namestring名称
∟ ∟ ∟ owner_idstring拥有者ID
∟ ∟ ∟ statusstring用户组状态
enable:正常;deleted:删除;
∟ ∟ ∟ typestring用户组类型
normal:普通用户组；
dept:部门用户组；
whole:全员用户组
∟ ∟ pinnedbool是否置顶
∟ ∟ user_rolestring当前成员角色信息
normal:普通成员；
admin:管理员；
owner:拥有者
∟ next_page_tokenstring下一页分页标记，<= 1024 characters；当查询结果中next_page_token为空或无该返回值时，代表无下一页。

响应体示例 ​

json
{
  "data": {
    "items": [
      {
        "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
          },
          "status": "inuse"
        },
        "group": {
          "avatar": "string",
          "company_id": "string",
          "creator_id": "string",
          "ctime": 1,
          "description": "string",
          "id": "string",
          "mtime": 1,
          "name": "string",
          "owner_id": "string",
          "status": "enable",
          "type": "normal"
        },
        "pinned": false,
        "user_role": "normal"
      }
    ],
    "next_page_token": "string"
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}