获取文集文档列表

用于获取指定文集的文档列表

## URL

`/api/get_docs/?token={token}`

## 请求方法

`GET`

#### 参数

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| `token` | string | 用户认证令牌，必填 |
| `pid` | string | 文集ID，必填 |
| `sort` | string | 排序方式，0为升序，1为降序，默认为0 |
| `limit` | int | 每页显示的文档数量，默认为10 |
| `page` | int | 当前页码，默认为1 |

## 响应结果

| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| `status` | bool | 请求状态，`true`表示成功，`false`表示失败 |
| `data` | list/dict | 响应数据，成功时为文档列表，失败时为错误信息 |
| `cnt` | int | 总文档数量（仅在成功时返回） |

### 文档列表数据结构

| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| `id` | int | 文档ID |
| `name` | string | 文档名称 |
| `parent_doc` | int | 上级文档ID |
| `top_doc` | int | 所属文集ID |
| `status` | int | 文档状态 |
| `create_time` | datetime | 文档创建时间 |
| `modify_time` | datetime | 文档修改时间 |
| `create_user` | string | 文档创建者用户名 |
| `editor_mode` | string | 文档类型 |

## 示例

### Python 示例

```python
# coding:utf-8

import requests

base_url = 'http://192.168.1.2'
token = '56968edc671b65265d20ab12631c7d5737edd0dab373e4e8e54a28f9'

url = base_url + '/api/get_docs/?token={}'.format(token)

params = {
    'pid': '58',
    'sort': '0',
    'limit': 10,
    'page': 1
}

resp = requests.get(url=url, params=params)
print(resp.json())
```

### 响应示例

成功响应：

```json
{
    "status": true,
    "data": [
        {
            "id": 1,
            "name": "文档1",
            "parent_doc": 0,
            "top_doc": 58,
            "status": 1,
            "create_time": "2023-01-01T12:00:00Z",
            "modify_time": "2023-01-02T12:00:00Z",
            "create_user": "user1",
            "editor_mode": "markdown"
        },
        ...
    ],
    "cnt": 20
}
```

失败响应：

```json
{
    "status": false,
    "data": "无文集权限"
}
```

### 错误码

| 错误信息 | 说明 |
| --- | --- |
| `无文集权限` | 用户没有该文集的浏览权限 |
| `token无效` | 提供的token无效或已过期 |
| `系统异常` | 系统内部错误 |

---