40 lines
1.1 KiB
Plaintext
40 lines
1.1 KiB
Plaintext
|
syntax = "v1"
|
|||
|
|
|
|||
|
|
info (
|
|||
|
|
title: "上传"
|
|||
|
|
desc: "图片上传，用于行驶证等需 URL 的接口"
|
|||
|
|
version: "v1"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
type (
|
|||
|
|
UploadImageReq {
|
|||
|
|
ImageBase64 string `json:"image_base64" validate:"required"` // 图片 base64（不含 data URL 前缀）
|
|||
|
|
}
|
|||
|
|
UploadImageResp {
|
|||
|
|
Url string `json:"url"` // 可公网访问的图片 URL
|
|||
|
|
}
|
|||
|
|
ServeUploadedFileReq {
|
|||
|
|
FileName string `path:"fileName"` // 文件名，如 uuid.jpg
|
|||
|
|
}
|
|||
|
|
// 实际由 Handler 根据 FilePath/ContentType 写文件流，不返回 JSON
|
|||
|
|
ServeUploadedFileResp {
|
|||
|
|
FilePath string `json:"-"` // 内部：本地文件路径
|
|||
|
|
ContentType string `json:"-"` // 内部：Content-Type
|
|||
|
|
}
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
@server (
|
|||
|
|
prefix: api/v1
|
|||
|
|
group: upload
|
|||
|
|
)
|
|||
|
|
service main {
|
|||
|
|
@doc "上传图片，返回可访问 URL（如行驶证）；限制 3MB"
|
|||
|
|
@handler UploadImage
|
|||
|
|
post /upload/image (UploadImageReq) returns (UploadImageResp)
|
|||
|
|
|
|||
|
|
@doc "访问已上传文件（供第三方或前端通过返回的 URL 拉取）"
|
|||
|
|
@handler ServeUploadedFile
|
|||
|
|
get /upload/file/:fileName (ServeUploadedFileReq) returns (ServeUploadedFileResp)
|
|||
|
|
}
|
|||
|
|
|