oss oss

模块 oss：共 6 个接口 —— 1 个被前端调用（在用），5 个未被调用（含 2 个开放/回调/内部）。用下方筛选可只看“在用/未使用”，或在右栏目录按名称过滤。

OssController 1/4 在用

POST /oss/download 未使用管理后台 #

对象存储-文件下载 · OssController

基本信息

控制器	com.jxxx.dscp.api.controller.oss.OssController#download
所属模块	oss `oss`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

调用链路（控制器方法内未解析到 Service/Mapper 调用，可能为接口声明或简单转发）

方法内调用IOUtils.toByteArray

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/oss/download
uat	https://dscp-uat.hn12301.net/manage-api/oss/download
pro	https://dscp-uat.hn12301.net/manage-api/oss/download	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /oss/download

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 toByteArray（IOUtils.toByteArray）

内联注释

设置response的Header

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /oss/multipartFileInit 未使用管理后台 #

对象存储-分片上传初始化 · OssController

基本信息

控制器	com.jxxx.dscp.api.controller.oss.OssController#multipartFileInit
所属模块	oss `oss`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerOssController#multipartFileInit

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

ObjectService.initiateMultipartUploadAmazonS3.initiateMultipartUploadOssProperties.getBucketName

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/oss/multipartFileInit
uat	https://dscp-uat.hn12301.net/manage-api/oss/multipartFileInit
pro	https://dscp-uat.hn12301.net/manage-api/oss/multipartFileInit	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　FileMultipartInitRequest

字段	类型	必填	取值/校验	表 / 列	说明
fileName	String	是	必填	—	文件名

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　FileMultipartInitResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
uploadId	String			—	分片上传编号

示例

请求示例（自动生成，仅结构参考）

POST /oss/multipartFileInit

{
  "body": {
    "fileName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "uploadId": ""
  }
}

处理逻辑

操作日志oss / 分片上传初始化

逻辑摘要调用 initiateMultipartUpload（objectService.initiateMultipartUpload）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /oss/multipartUpload 未使用管理后台 #

对象存储-分片上传 · OssController

基本信息

控制器	com.jxxx.dscp.api.controller.oss.OssController#multipartUpload
所属模块	oss `oss`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerOssController#multipartUpload

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 8

ObjectService.uploadPartAmazonS3.uploadPartOssProperties.getBucketNameObjectService.completeMultipartUploadAmazonS3.completeMultipartUploadAmazonS3.getUrlObjectService.getObjectURLAmazonS3.generatePresignedUrl

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/oss/multipartUpload
uat	https://dscp-uat.hn12301.net/manage-api/oss/multipartUpload
pro	https://dscp-uat.hn12301.net/manage-api/oss/multipartUpload	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	file	MultipartFile	否		—

请求参数 · Body　MultipartUploadRequest

字段	类型	必填	取值/校验	表 / 列	说明
uploadId	String	是	必填	—	上传Id
totalChunks	Integer	是	必填	—	分片总数
chunkNumber	Integer	是	必填	—	分片编号
fileKey	String	是	必填	—	文件key

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　FileUploadResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
fileName	String			—	文件名
fileUrl	String			—	文件链接

示例

请求示例（自动生成，仅结构参考）

POST /oss/multipartUpload?file=…

{
  "body": {
    "uploadId": "",
    "totalChunks": 0,
    "chunkNumber": 0,
    "fileKey": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "fileName": "",
    "fileUrl": "https://example.com/x.png"
  }
}

处理逻辑

操作日志oss / 分片上传

逻辑摘要调用 uploadPart（objectService.uploadPart）；调用 toByteArray（IOUtils.toByteArray）；调用 completeMultipartUpload（objectService.completeMultipartUpload）

内联注释

分段上传
插入eTag
删除map数据

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /oss/uploadWithFaceCheck 在用开放/回调 #

OSS-图片上传（含人脸检测校验） · OssController

基本信息

控制器	com.jxxx.dscp.api.controller.oss.OssController#uploadWithFaceCheck
所属模块	oss `oss`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerOssController#uploadWithFaceCheck

ServiceobjectService#putObject

ServiceobjectService#getObjectURL

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/oss/uploadWithFaceCheck
uat	https://dscp-uat.hn12301.net/open-api/oss/uploadWithFaceCheck
pro	https://dscp-uat.hn12301.net/open-api/oss/uploadWithFaceCheck	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	类型	名称	注解
Query	MultipartFile	file	value = "file", required = false

请求参数 · Body

无 JSON Body（multipart 文件参数见上）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　FileUploadResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
fileName	String			—	文件名
fileUrl	String			—	文件链接

示例

请求示例

（multipart/form-data 文件上传）

响应示例

{
  "fileName": "",
  "fileUrl": ""
}

处理逻辑

操作日志oss / 文件上传

逻辑摘要objectService.putObject；objectService.getObjectURL；完整实现见源码 OssController#uploadWithFaceCheck

内联注释

获取文件后缀名
String suffix = originalFilename.substring(originalFilename.
上传文件

前端调用方

pingxiangcard uploadWithFaceCheck exact

开放/回调/内部接口（2，精简表 · 均未被前端调用）

方法	路径	渠道	摘要	调用方
POST	/oss/upload	开放/回调	对象存储-文件上传	—
POST	/oss/uploadBase64	开放/回调	对象存储-文件上传	—