Feat: add swagger notes

2025-12-07 05:19:10 +08:00
parent 56e83b0725
commit 9c30bc009d
11 changed files with 775 additions and 15 deletions
--- a/handlers/api/getImages.go
+++ b/handlers/api/getImages.go
@@ -9,14 +9,16 @@ import (

 type getImagesOutputImage struct {
 	Id       int64    `json:"id"`
-	Uploader string   `json:"uploaded_user_id"`
-	UploadTS int64    `json:"uploaded_at"`
+	Uploader string   `json:"uploadedUserId"`
+	UploadTS int64    `json:"uploadedAt"`
 	Aliases  []string `json:"aliases"`
 }

 // GetImages
 //
-//	@success	200	{object}	getImagesOutputImage
+//	@param		images	query		[]int64	false	"Image Ids"	attribute(optional)
+//	@param		aliases	query		[]int64	false	"Alias Ids"	attribute(optional)
+//	@success	200		{object}	[]getImagesOutputImage
 //	@failure	400
 //	@failure	401
 //	@router		/api/images [get]