// Package api 提供 Web 管理接口(Gin),遵循统一响应与分页约定。 package api import ( "net/http" "github.com/gin-gonic/gin" ) // Response 统一响应结构 type Response struct { Code int `json:"code"` Message string `json:"message"` Data interface{} `json:"data"` } // Success 成功响应 func Success(c *gin.Context, data interface{}) { c.JSON(http.StatusOK, Response{ Code: http.StatusOK, Message: "success", Data: data, }) } // Error 失败响应(仅允许 400 / 500) func Error(c *gin.Context, statusCode int, message string) { c.JSON(statusCode, Response{ Code: statusCode, Message: message, Data: nil, }) } // PageResult 分页响应体 type PageResult struct { List []interface{} `json:"list"` Total int64 `json:"total"` }