Struct OssService 

pub struct OssService;

OSS 服务

Implementations

impl OssService

pub async fn upsert_oss( state: &AppState, dto: OssDto, member_id: i32, ) -> ApiResult<()>

新增或更新 OSS 文件记录并绑定到话数岗位。

Errors

• AppError::Database — 数据库写入失败
• AppError::Internal — COS STS 凭证获取失败

pub async fn get_upload_credential( state: &AppState, episode_id: i32, post_name: String, filename: String, ) -> ApiResult<OssCredential>

获取 COS 文件上传预签名凭证。

返回值

返回 OssCredential，包含预签名上传 URL 和对象 Key。

Errors

• AppError::business("文件后缀不允许上传喵") — 后缀不在白名单
• AppError::business("文件超出XXMB限制喵") — 文件超过大小限制

pub async fn get_image_upload_credential( state: &AppState, image_type: String, filename: String, ) -> ApiResult<OssCredential>

获取图片上传凭证

pub async fn get_download_credential( state: &AppState, episode_id: i32, post_name: String, ) -> ApiResult<OssCredential>

获取文件下载预签名 URL。

返回值

返回 OssCredential，presigned_url 为 CDN 鉴权链接。

Errors

• AppError::DownloadUnAuth — 无下载权限

pub async fn download_redirect_target( state: &AppState, episode_id: i32, post_name: String, ) -> ApiResult<(String, String)>

鉴权后返回 CDN 直链与文件名（用于 302 跳转）。

返回值

(presigned_url, filename) — CDN 鉴权链接和原始文件名。

Errors

• AppError::DownloadUnAuth — 无下载权限（由 get_download_credential 传播）

pub async fn download_file_proxy( state: &AppState, episode_id: i32, post_name: String, ) -> ApiResult<(String, Bytes)>

服务端代理拉取 OSS/CDN 文件。

CORS 不可用时的回退路径：服务器下载后返回给客户端。

返回值

(filename, bytes) — 原始文件名和文件内容。

Errors

• AppError::Internal("拉取 OSS 文件失败: ...") — HTTP 请求失败
• AppError::Oss { msg: "OSS 下载失败: HTTP XXX" } — OSS 返回非 2xx
• AppError::Internal("读取 OSS 文件失败: ...") — 响应体读取失败