列出目录

列出指定目录下的文件和子目录（非递归）。

• 接口路径：POST /v1/openapi/app/files/list

请求头

参数名	必填	说明
Content-Type	是	application/json
Authorization	是	鉴权凭证，格式 Bearer sk_xxx

请求参数

{
  "user_id": "user123",
  "path": "/data"
}

参数名	类型	必填	说明
user_id	string	是	业务方用户 ID，用于确定所属工作空间
path	string	否	目标路径，默认 /

响应示例

{
  "code": 200,
  "data": {
    "path": "/data",
    "files": [
      {
        "name": "file.csv",
        "path": "/data/file.csv",
        "size": 1024,
        "is_dir": false,
        "mod_time": "2026-04-27T10:30:00Z",
        "url": "https://obs.example.com/workspaces/.../data/file.csv"
      },
      {
        "name": "subdir",
        "path": "/data/subdir",
        "size": 0,
        "is_dir": true,
        "mod_time": "2026-04-27T09:00:00Z"
      }
    ]
  },
  "message": "",
  "trace_id": "abc123"
}

字段	类型	说明
path	string	当前目录路径
files	array	目录内容列表，字段结构见文件对象结构