Golang如何实现API接口统一返回_Golang API响应结构设计实践

<strong>type Response struct {
    Code    int         `json:"code"`
    Message string      `json:"message"`
    Data    interface{} `json:"data,omitempty"`
    Timestamp int64     `json:"timestamp"`
}</strong>

<strong>func Success(data interface{}) *Response {
    return &Response{
        Code:      0,
        Message:   "success",
        Data:      data,
        Timestamp: time.Now().Unix(),
    }
}

func Error(code int, message string) *Response {
    return &Response{
        Code:      code,
        Message:   message,
        Data:      nil,
        Timestamp: time.Now().Unix(),
    }
}</strong>

<strong>func GetUser(w http.ResponseWriter, r *http.Request) {
    user := map[string]interface{}{
        "id":   1,
        "name": "Alice",
    }
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(Response.Success(user))
}</strong>

<strong>func ApiResponseMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        c.Next()

        // 检查是否已有错误
        if len(c.Errors) > 0 {
            err := c.Errors[0]
            c.JSON(http.StatusOK, Response.Error(-1, err.Error()))
            return
        }

        // 获取数据并包装
        responseData := c.Keys["response_data"]
        c.JSON(http.StatusOK, Response.Success(responseData))
    }
}</strong>

<strong>c.Set("response_data", user)
return</strong>