如何解决如何使用接受多部分/表单数据的goDoc记录我的服务端点
我有一个用Go / Gin编写的服务,其中我接受multipart / form-data接受用户的文件列表。代码看起来像这样。
func UploadScreenshotsHandler(c *gin.Context) {
//Multipart form
form,err := c.MultipartForm()
if err != nil {
logger.Log.Error(err.Error())
c.JSON(http.StatusBadRequest,gin.H{"error": err.Error()})
return
}
files := form.File
// more logics with the files
}
我正在使用GoDoc记录我的端点。那么,如何指定我的godoc,以便使摇摇欲坠的人知道这是一个接受multipart / form-data的端点?
// UploadFileHandler godoc
// @Summary Upload a list of file
// @Description An API for clients to upload files
// @Param <WHAT DO I PUT HERE??> <----------
// @Success 200 "Successfully uploaded"
// @Failure 400 {object} interface{} "Bad request: request body has to be form-data"
// @Router / [post]
解决方法
指定端点接收多个文件
// UploadFile godoc
// @Summary Uploads a file
// @Description Takes in a file as part of a multipart form and stores the file
// @Tags Uploads
// @Accept multipart/form-data
// @Produce json
// @Param file formData file true "File 1 to upload"
// @Param file1 formData file true "File 2 to upload"
// @Success 200 "Successfully uploaded"
// @Failure 400 {object} interface{} "Bad request: request body has to be form-data"
// @Router / [post]
func UploadHandler(c *gin.Context) {
...
}
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。