## URL

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

## 请求方法

`POST`

## 参数

### Query 参数

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

### Body 参数（form-data）

| 参数名 | 数据类型 | 是否必填 | 含义 |
| --- | --- | --- | --- |
| attachment_upload | file | 是 | 需要上传的附件文件 |

## 响应结果

| 字段名 | 数据类型 | 含义 |
| --- | --- | --- |
| status | boolean | 请求是否成功，true为成功，false为失败 |
| data | string | 上传成功时返回附件信息，失败时返回错误消息 |

### 响应示例

**成功响应：**
```json
{
    "status": true,
    "data": "附件上传后的URL或标识信息"
}
```

**失败响应：**
```json
{
    "status": false,
    "data": "用户无权限操作"
}
```

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

```json
{
    "status": false,
    "data": "上传出错"
}
```

## 权限说明

- 用户必须具有作者（writer）权限
- 用户的 `writer_value[3]` 必须为 `'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_attachment/?token={token}'

# 本地附件路径
attachment_path = '/path/to/your/file.pdf'

# 上传附件
with open(attachment_path, 'rb') as f:
    files = {'attachment_upload': f}
    resp = requests.post(url, files=files)
    print(resp.json())
```

## 错误码说明

| 错误消息 | 说明 |
| --- | --- |
| token无效 | 提供的Token不存在或已过期 |
| 用户无权限操作 | 当前用户没有上传附件的权限 |
| 上传出错 | 服务器处理上传时发生异常 |