使用 go 构建 restful api 并在 swagger 文档中提供可读端点描述。创建 go 模块并使用 gin 框架。添加 swagger 文档以生成 api 文档。定义端点，例如“创建用户”，并相应编写 swagger 定义。

使用 Golang 构建 RESTful API 并使用 Swagger 文档

简介

构建 RESTful API 是创建现代、可互操作 Web 服务的基础。Go 语言提供了构建高性能、可扩展 API 所需的工具和库。此外，Swagger 文档可以帮助自动生成 API 文档，使开发人员轻松理解您的 API。

构建 RESTful API

创建 Go 模块

go mod init rest-api

使用 Gin 框架

import "<a style='color:#f60; text-decoration:underline;' href="https://www.php.cn/zt/15841.html" target="_blank">git</a>hub.com/gin-gonic/gin"

func main() {
    r := gin.Default()
    r.GET("/users", getUsers)
    r.Run(":8080")
}

func getUsers(c *gin.Context) {
    c.JSON(200, "Hello world!")
}

添加 Swagger 文档

import "github.com/swaggo/swag/example/restapi/swagger"

swagger.Register(r)

运行您的应用程序：

go run main.go

实战案例

假设您正在构建一个用户管理 API。您可以使用以下代码创建创建用户的端点：

func createUser(c *gin.Context) {
    var user User
    if err := c.ShouldBindJSON(&user); err != nil {
        c.JSON(400, gin.H{"error": err.Error()})
        return
    }

    if err := userService.Create(user); err != nil {
        c.JSON(500, gin.H{"error": err.Error()})
        return
    }

    c.JSON(201, user)
}

请注意，此代码需要一个 userService 用于创建用户。您还应该按照 Swagger 规范编写相应的 Swagger 定义。

结论

本教程向您展示了如何使用 Golang 构建 RESTful API 并使用 Swagger 文档将其公开。通过遵循这些步骤，您可以轻松构建健壮、可扩展的 API 并为开发人员提供所需的文档。