首页 > Golang > Go教程

Golang实现GET与POSTJSON接口教程

时间：2025-09-24 20:00:59 240浏览收藏

想用Golang快速构建支持GET和POST请求的JSON API吗？本文将提供一份详尽的教程，教你如何利用Go标准库轻松实现。无需引入额外框架，即可通过`net/http`包注册路由，定义数据结构`Data`，并实现GET请求返回预设JSON数据，以及POST请求解析请求体并回显。教程包含完整代码示例，展示如何创建、启动HTTP服务器，处理GET和POST请求，并设置正确的Content-Type头。通过简单的`curl`命令，即可测试API的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的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~

golang net/http GET请求 POST请求 JSONAPI