资源工坊

获取子文件列表 ​

标签：文件

请求说明 ​

字段值
请求地址
https://openapi.wps.cn/v7/drives/{drive_id}/files/{parent_id}/children
HTTP 方法
GET
接口描述
获取子文件列表
签名方式
KSO-1
限频策略
无
权限要求
查询和管理文件(应用授权) kso.file.readwrite
查询文件(应用授权) kso.file.read
查询和管理文件(用户授权) kso.file.readwrite
查询文件(用户授权) kso.file.read

请求头 (Headers) ​

属性名类型是否必填描述可选值
X-Kso-Id-Type
string否类型
* internal - 内部
* external - 外部
internal, external

路径参数 (Path) ​

属性名类型是否必填描述可选值
drive_id
string是驱动盘id-
parent_id
string是文件夹id（根目录时为0）-

查询参数 (Query) ​

属性名类型是否必填描述可选值
with_permission
boolean否是否返回文件操作权限-
with_ext_attrs
boolean否是否返回文件扩展属性-
filter_exts
string否过滤条件,扩展名以英文逗号分隔，不需要空格，扩展名全部小写,不传或者空字符串表示不过滤-
filter_type
object否按照文件类型筛选，例如：file、folder、shortcut等-
order
string否排序方式：升序和降序desc, asc
order_by
string否排序字段ctime, mtime, dtime, fname, fsize
page_size
integer是分页大小,公网限制最大为500-
page_token
string否分页token-

响应体(Response) ​

HTTP状态码: 200
响应体格式: application/json

没有可用的数据

响应体示例 ​

json
{
  "data": {
    "items": [
      {
        "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
      }
    ],
    "next_page_token": "string"
  },
  "code": 0,
  "msg": "string"
}