通用图片上传

上传图片

POST /api/open/v1/upload

权限：open:upload

Content-Type：multipart/form-data

请求参数：

参数	类型	必填	说明
file	binary	是	图片文件，支持 jpg/jpeg/png/gif/webp，最大 10MB
sub_dir	string	否	存储子目录，仅支持字母、数字、下划线，默认 open_api

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "path": "uploads/open_api/a1b2c3d4e5f6.jpg",
        "url": "https://cdn.example.com/uploads/open_api/a1b2c3d4e5f6.jpg"
    }
}

响应字段说明：

字段	类型	说明
path	string	存储相对路径，可用于入库关联
url	string	可访问的完整 URL（OSS 签名 URL 或 CDN 地址）

错误码：

code	说明
40001	文件类型不支持或参数无效
40002	图片内容含违规信息
41301	请求体过大（超过 10MB）

---

使用说明

1. 上传后获取 URL：调用上传接口后，将返回的 url 或 path 用于其他接口（如创建/更新嘉宾时传入图片字段）。
2. sub_dir 用途：通过 sub_dir 参数可将图片分类存储到不同子目录，便于管理。例如传入 guests、activities 等。
3. 签名认证：该接口为 multipart/form-data 请求，签名计算时使用空 body 的 MD5（即 md5("")），与普通 JSON 接口不同。详见认证方式。
4. 内容安全：上传的图片会经过微信内容安全审核，违规图片将被拒绝。