我已经拿到了一个目录的 gns，想列出它下面的所有子项，并且按文件名排序、带上文件属性信息。该调哪个接口？请求体怎么写？
1 Answers
使用 POST /api/efast/v1/dir/list（浏览目录协议，支持用户账户与应用账户调用）。
请求体字段（DirListReq）：
| 字段 | 必填 | 说明 |
|---|---|---|
docid |
是 | 要浏览的目录 gns 路径。 |
by |
否 | 排序字段：name / size / time / creator_name / editor_name / create_time，默认按 docid 升序。 |
sort |
否 | asc / desc，默认升序。 |
attr |
否 | 是否获取属性信息，默认 false。 |
need_tag |
否 | 是否获取标签信息，默认 false。 |
catalog |
否 | 编目信息查询条件。 |
请求示例：
POST /api/efast/v1/dir/list HTTP/1.1
Host: 192.168.1.100
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json
{
"docid": "gns://21A9B9FD1B524CB49D54BF7399F82EB4",
"by": "name",
"sort": "asc",
"attr": true
}
说明： 返回结果中每个子项都会带 docid、name、type（file 或 folder）等字段。对返回的 folder 类型子项再次调用本接口即可逐层下钻；对 file 类型可进一步获取元数据或下载。