首页 > Golang > Go教程

Golang实现GET与POSTJSON接口详解

时间：2025-09-02 18:37:44 495浏览收藏

想要快速搭建一个支持GET和POST请求的JSON API吗？本文将带你使用Golang标准库，无需额外框架，轻松实现这一目标。通过`net/http`包注册路由，定义数据结构`Data`，利用`json`包进行JSON的编码和解码，实现GET请求返回预设JSON数据，POST请求解析请求体并回显数据的功能。本文提供完整可运行的代码示例，并详细讲解了如何创建HTTP服务器、处理GET和POST请求，以及如何使用`curl`命令进行API测试。学会这些，你就能用Golang高效地构建简单的JSON API，并为后续的扩展打下坚实基础。掌握Golang JSON API开发，提升你的后端开发效率！

答案是使用Go标准库可轻松实现支持GET和POST的JSON API。通过net/http注册路由，定义Data结构体，GET返回预设数据，POST解析请求体并回显，设置正确Content-Type头，最终用curl测试正常收发JSON。

如何用Golang编写一个处理GET和POST请求的简单JSON API

用Golang编写一个能处理GET和POST请求的简单JSON API并不复杂。Go的标准库提供了足够的工具，无需引入外部框架即可实现。下面是一个完整、可运行的示例，展示如何创建一个接收JSON数据、返回JSON响应的基础API。

1. 创建基本的HTTP服务器

使用net/http包启动一个HTTP服务器，并注册处理函数。

以下代码启动服务器并监听:8080端口：

main.go

package main

import (
    "encoding/json"
    "log"
    "net/http"
)

func main() {
    http.HandleFunc("/api/data", handleData)
    log.Println("Server starting on :8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

2. 处理GET请求：返回JSON数据

当客户端发送GET请求到/api/data时，返回预设的JSON数据。

type Data struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

func handleData(w http.ResponseWriter, r *http.Request) {
    switch r.Method {
    case "GET":
        data := Data{ID: 1, Name: "example"}
        w.Header().Set("Content-Type", "application/json")
        json.NewEncoder(w).Encode(data)

    case "POST":
        // 处理POST见下文
    default:
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
    }
}

3. 处理POST请求：接收并解析JSON

客户端发送JSON数据到/api/data，服务端解析并返回确认信息。

更新handleData中的POST分支：

case "POST":
    var data Data
    if err := json.NewDecoder(r.Body).Decode(&data); err != nil {
        http.Error(w, "Invalid JSON", http.StatusBadRequest)
        return
    }

    // 简单响应，回显收到的数据
    response := map[string]string{
        "status": "received",
        "id":     fmt.Sprintf("%d", data.ID),
        "name":   data.Name,
    }

    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(http.StatusCreated)
    json.NewEncoder(w).Encode(response)

别忘了导入"fmt"包。

4. 测试你的API

启动服务：

go run main.go

测试GET请求：

curl -X GET http://localhost:8080/api/data

输出：

{"id":1,"name":"example"}

测试POST请求：

curl -X POST http://localhost:8080/api/data \
     -H "Content-Type: application/json" \
     -d '{"id": 2, "name": "test"}'

输出：

{"status":"received","id":"2","name":"test"}

基本上就这些。这个小例子展示了Go如何轻松处理JSON API的核心需求：路由、解析请求、生成响应。你可以在此基础上扩展验证、数据库交互或中间件功能。

今天关于《Golang实现GET与POSTJSON接口详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！

golang net/http GET请求 POST请求 JSONAPI