## URL

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

## 请求方法

`POST`

## 参数

### Query 参数

| 参数名   | 数据类型   | 是否必填 | 含义                   |
| ----- | ------ | ---- | -------------------- |
| token | string | 是    | 用户 Token，用于身份验证和权限校验 |

### Body 参数（form-data）

| 参数名        | 数据类型    | 是否必填 | 含义                                                           |
| ---------- | ------- | ---- | ------------------------------------------------------------ |
| pid        | integer | 是    | 文集 ID，Office 文档将创建到指定文集中                                     |
| parent_doc | integer | 否    | 父级文档 ID，默认为 `0`，表示创建为一级文档                                    |
| file       | file    | 是    | 上传的 Office 文件，支持 Word、Excel、PowerPoint 等 MrDoc 支持的 Office 格式 |

## 响应结果

| 字段名    | 数据类型            | 含义                              |
| ------ | --------------- | ------------------------------- |
| status | boolean         | 请求是否成功，`true` 表示成功，`false` 表示失败 |
| data   | object / string | 成功时返回文档信息，失败时返回错误消息             |

### 响应示例

**成功响应：**

```json
{
    "status": true,
    "data": {
        "doc_id": 123,
        "filename": "2026/07/项目需求文档.docx"
    }
}
```

返回字段说明：

| 字段名      | 数据类型    | 含义                          |
| -------- | ------- | --------------------------- |
| doc_id   | integer | 创建成功后的文档 ID                 |
| filename | string  | Office 文件在 MrDoc 存储目录中的相对路径 |

**失败响应：**

Token 无效：

```json
{
    "status": false,
    "data": "token无效"
}
```

用户无权限：

```json
{
    "status": false,
    "data": "用户无权限操作"
}
```

参数错误：

```json
{
    "status": false,
    "data": "参数错误"
}
```

无文集权限：

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

未选择文件：

```json
{
    "status": false,
    "data": "未选择文件"
}
```

文件大小超出限制：

```json
{
    "status": false,
    "data": "文件大小超出限制"
}
```

文件格式不支持：

```json
{
    "status": false,
    "data": "文件格式不支持"
}
```

系统异常：

```json
{
    "status": false,
    "data": "系统异常"
}
```

---

## 权限说明

* 用户必须具有作者（Writer）权限。
* 用户必须具有新增文档权限（`writer_value[1] == '1'`）。
* 用户必须拥有目标文集的新增权限，否则接口将返回 **"无文集权限"**。

---

## Python 示例

```python
# coding: utf-8

import requests

# MrDoc 地址
base_url = 'http://192.168.1.2'

# 用户 Token
token = '56968edc671b65265d20ab12631c7d5737edd0dab373e4e8e54a28f9'

url = f'{base_url}/api/upload_office_doc/?token={token}'

# 上传到的文集ID
pid = 1

# 父级文档ID（0表示一级文档）
parent_doc = 0

# 本地 Office 文件
office_file = '/path/to/项目需求文档.docx'

with open(office_file, 'rb') as f:
    files = {
        'file': f
    }
    data = {
        'pid': pid,
        'parent_doc': parent_doc
    }

resp = requests.post(url, data=data, files=files)
    print(resp.json())
```

---

## 错误码说明

| 错误消息     | 说明                            |
| -------- | ----------------------------- |
| token无效  | 提供的 Token 不存在或已失效             |
| 用户无权限操作  | 当前用户没有创建文档权限                  |
| 参数错误     | 请求缺少必要参数（如 `pid`）             |
| 无文集权限    | 当前用户没有目标文集的新增权限               |
| 未选择文件    | 请求中未上传 Office 文件              |
| 文件大小超出限制 | 上传文件超过系统允许的最大大小或文件为空          |
| 文件格式不支持  | 上传的文件不是 MrDoc 支持的 Office 文档格式 |
| 系统异常     | 服务器处理请求时发生异常                  |

上传本地Office/PDF文件为文档