项目初始化

09-后台API说明/文件上传接口字段清单.md

@@ -0,0 +1,23 @@
+# 文件上传接口字段清单
+
+## 1. 获取上传凭证
+- 接口路径：`POST /api/common/upload-token`
+- 功能说明：获取文件上传所需凭证或预签名地址。
+
+### 请求参数
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| bizType | string | 是 | 业务类型，如 merchant_license/event_cover |
+| fileName | string | 是 | 文件名 |
+| contentType | string | 是 | 文件类型 |
+
+### 返回字段
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| uploadUrl | string | 上传地址 |
+| fileKey | string | 文件存储Key |
+| expireAt | string | 过期时间 |
+
+## 2. 上传完成回写
+- 接口路径：`POST /api/common/upload-callback`
+- 功能说明：记录文件上传完成后的元数据。