【golang】请求HTTP接口代码示例

已于 2023-07-03 01:23:21 修改
阅读量990 收藏 2
点赞数
分类专栏： Golang 文章标签： golang http
于 2023-07-02 22:01:50 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/ljfrocky/article/details/131501518
版权

前言

在开发过程中，无论是前端还是后端，都经常需要对第三方服务发起HTTP请求获取数据，本文列出一些代码示例用于参考，主要是 GET 请求 和 POST 请求。

环境

Go 1.20
Windows 11

示例

1、GET请求，不带参数
package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
	"time"
)

func main() {
	apiUrl := "http://localhost/test.php"
	client := &http.Client{Timeout: 5 * time.Second} // 5秒超时
	resp, err := client.Get(apiUrl)
	if err != nil {
		log.Fatal("请求报错：", err)
	}
	defer resp.Body.Close()
	// 判断HTTP状态码是否等于200
	if resp.StatusCode != http.StatusOK {
		log.Fatal("HTTP状态码异常：", resp.StatusCode)
	}
	// 读取HTTP Body
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		log.Fatal("读取响应体失败：", err)
	}

	fmt.Println("HTTP状态码：", resp.StatusCode)
	fmt.Println("HTTP响应头：", resp.Header) // 响应头是个map
	fmt.Println("HTTP响应体：", string(body))
}
2、GET请求，带参数

众所周知，GET请求携带参数的方式是：http://www.mysite.com?key1=value1&key2=value2

如果参数含有特殊字符，则需要对其进行URL编码。在URL编码里有两种规范，一种是RFC 1738，另一种是RFC 3986

两种规范的编码方式会有区别，例如：对于空格字符，RFC 1738会将其编码成加号+，而RFC 3986则会编码成%20

RFC 1738编码代码示例：

package main

import (
	"fmt"
	"net/http"
	"net/url"
)

func main() {
	apiUrl := "http://localhost/test.php?%s"
	params := url.Values{}
	params.Add("key1", "Foo Bar")
	params.Add("key2", "中文参数")
	fullUrl := fmt.Sprintf(apiUrl, params.Encode())
	// fullUrl的值：
	// http://localhost/test.php?key1=Foo+Bar&key2=%E4%B8%AD%E6%96%87%E5%8F%82%E6%95%B0

	client := &http.Client{Timeout: 5 * time.Second} // 5秒超时
	resp, err := client.Get(fullUrl)

	// 下面代码跟例子1一样
}

由于 net/url 包的 Encode 方法没有提供参数让我们选择用哪种规范进行编码，所以如果想使用RFC 3986方式编码的话需要另外想办法

RFC 3986编码代码示例：

package main

import (
	"fmt"
	"net/url"
	"strings"
)

func main() {
	params := map[string]string{
		"key1": "Foo Bar",
		"key2": "中文参数",
	}

	var kvPair []string
	for key, val := range params {
		kvPair = append(kvPair, key+"="+url.PathEscape(val))
	}
	queryString := strings.Join(kvPair, "&")

	apiUrl := "http://localhost/test.php?%s"
	fullUrl := fmt.Sprintf(apiUrl, queryString)
	// fullUrl的值：
	// http://localhost/test.php?key1=Foo%20Bar&key2=%E4%B8%AD%E6%96%87%E5%8F%82%E6%95%B0

    client := &http.Client{Timeout: 5 * time.Second} // 5秒超时
	resp, err := client.Get(fullUrl)

	// 下面代码跟例子1一样
}
3、POST请求（application/x-www-form-urlencoded）

这种 POST 编码方式不支持上传文件，上传文件请看例子4

POST请求，传递 key1 和 key2 两个参数：

package main

import (
	"net/http"
	"net/url"
)

func main() {
	apiUrl := "http://localhost/test.php"

	params := url.Values{}
	params.Add("key1", "Hello World")
	params.Add("key2", "你好")
	client := &http.Client{Timeout: 5 * time.Second} // 5秒超时
	resp, err := client.PostForm(apiUrl, params)

	// 下面代码跟例子1一样
}
4、POST请求（multipart/form-data）

假设现在要上传2个文件，和一个普通的字符串参数（key1），代码示例：

package main

import (
	"bytes"
	"fmt"
	"io"
	"log"
	"mime/multipart"
	"net/http"
	"os"
	"path/filepath"
)

func main() {
	buf := new(bytes.Buffer)
	mpWriter := multipart.NewWriter(buf)

	// 添加普通的字符串参数，非必须，如果只需上传文件可以注释掉
	// 普通字符串参数在PHP里是从 $_POST 获取
	err := mpWriter.WriteField("key1", "value1")
	if err != nil {
		log.Fatal("写入buffer报错：", err)
	}

	// 添加上传文件内容，filepath是文件的绝对路径
	// 上传文件内容在PHP里是从 $_FILES 获取
	fileBucket := [...]map[string]string{
		{"key": "file1", "filepath": "D:\\file1.txt"},
		{"key": "file2", "filepath": "D:\\file2.txt"},
	}
	for _, val := range fileBucket {
		file, err := os.Open(val["filepath"])
		if err != nil {
			log.Fatal("打开文件报错：", err)
		}
		defer file.Close()

		part, err := mpWriter.CreateFormFile(val["key"], filepath.Base(val["filepath"]))
		if err != nil {
			log.Fatal("创建上传文件字段失败：", err)
		}
		if _, err := io.Copy(part, file); err != nil {
			log.Fatal("复制文件内容失败：", err)
		}
	}
	mpWriter.Close()

	// 可以发送请求啦
	apiUrl := "http://localhost/test.php"
	client := &http.Client{Timeout: 5 * time.Second} // 5秒超时
	resp, err := client.Post(apiUrl, mpWriter.FormDataContentType(), buf)

	// 下面代码跟例子1一样
}

注：此方法需要将待上传文件的数据全部读取到 bytes.Buffer，上传文件越大，越消耗内存。

5、POST请求（JSON）

在 POST 请求中，使用 JSON 来交互经常见，代码示例：

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"log"
	"net/http"
	"time"
)

type Teacher struct {
	ID        string `json:"id"`
	Firstname string `json:"firstname"`
	Lastname  string `json:"lastname"`
}

func main() {
	teacher := Teacher{
		ID:        "42",
		Firstname: "John",
		Lastname:  "Doe",
	}
	marshalled, err := json.Marshal(teacher)
	if err != nil {
		log.Fatal("转换JSON失败：", err)
	}

	// 发起请求
	apiUrl := "http://localhost/test.php"
	client := &http.Client{Timeout: 5 * time.Second} // 5秒超时
	resp, err := client.Post(apiUrl, "application/json", bytes.NewReader(marshalled))

	// 下面代码跟例子1一样
}

进阶用法

1、自定义请求头

以 GET 请求作为示例，添加两个自定义请求头（X-Csrf-Token和X-Request-ID）：

package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
)

func main() {
	apiUrl := "http://localhost/test.php"
	req, err := http.NewRequest(http.MethodGet, apiUrl, nil)
	if err != nil {
		log.Fatal("创建请求失败：", err)
	}
	req.Header.Add("X-Csrf-Token", "xxxxxx")
	req.Header.Add("X-Request-ID", "YYYYYY")

	// 可以发送请求啦
	client := &http.Client{Timeout: 5 * time.Second} // 5秒超时
	resp, err := client.Do(req)

	// 下面代码跟例子1一样
}

Header.Add() 和 Header.Set() 的区别：
Header在底层是个map[string][]string类型，可以看出header的值是个切片，Add方法就是往切片里添加一个元素，而Set则是把整个已有的切片替换掉。

但无论切片里有多少个元素，Golang的Header.Get()方法获取到的都是第一个元素。而PHP则刚好相反，我用$_SERVER['HTTP_XXXXX']获取到的是最后一个元素。

2、超时设置

细心的小伙伴可能会注意到，在上面的代码示例中，都有一行client := &http.Client{Timeout: 5 * time.Second}，这是创建一个http client，用于发起请求。

其实net/http包自身就包含有一个默认的http client（http.DefaultClient），但这个 client 默认是没有设置超时时间的，这是很危险的做法，如果一旦遇到接口响应慢的情况，我们的代码可能就会卡在这里很久，像http.Get()、http.Post()、http.PostForm()、http.DefaultClient.Do()都是使用默认的client。

所以在上面的代码示例里，都没有使用默认的client，而是新建一个包含 5 秒超时时间设置的 client 来发起请求。

3、并发请求

如果有多个接口需要请求，而且请求之间没有依赖关系的话，我们可以使用协程并发请求，相比一个一个请求能节省很多时间。下面以GET方式并发请求2个接口为例：

package main

import (
	"fmt"
	"io"
	"net/http"
	"sync"
	"time"
)

func getRequest(api string) (respBody string, err error) {
    client := &http.Client{Timeout: 5 * time.Second} // 5秒超时
	resp, err := client.Get(api)
	if err != nil {
		return "", err
	}
	defer resp.Body.Close()
	// 判断HTTP状态码是否等于200
	if resp.StatusCode != http.StatusOK {
		return "", fmt.Errorf("HTTP状态码异常：%v", resp.StatusCode)
	}
	// 读取HTTP Body
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		return "", err
	}
	return string(body), nil
}

func main() {
	timeStart := time.Now()
	defer func() {
		fmt.Println("执行时间：", time.Since(timeStart))
	}()

	// 要请求的接口
	apis := [...]string{
		"http://localhost/test.php",
		"http://localhost/test2.php",
	}

	// 使用协程并发请求
	wg := sync.WaitGroup{}
	respBucket := make(map[string]string)
	for _, api := range apis {
		wg.Add(1)
		go func(api string) {
			defer wg.Done()
			resp, err := getRequest(api)
			if err != nil {
				fmt.Println("请求失败：", err)
				return
			}
			respBucket[api] = resp
		}(api)
	}

	// 等待结果
	wg.Wait()
	fmt.Println("请求结果：", respBucket)
}

代码示例中，请求了2个接口，其中一个接口需耗时2秒，另一个需耗时4秒。使用协程并发请求，只花费了4秒时间，而不是6秒。

自由de单车
关注
  • 0
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Go语言HTTP请求流式写入body的示例代码
12-17
body 是通过 io.Reader 接口来传递，并没有暴露一个 io.Writer 接口来提供写入的办法，先来看看正常情况下怎么写入一个 body ，示例： 需要先把要写 buf := bytes.NewBuffer([]byte("hello")) http.Post("localhost...
golang实现http server提供文件下载功能
09-17
总结一下，Golang的`net/http`包使得创建HTTP服务器变得简单，同时提供了丰富的工具来处理请求和响应。在实现文件下载功能时，我们需要注意设置正确的HTTP响应头，确保客户端能够正确地处理下载过程。理解这些基本...
【Go】——Golang处理HTTP/HTTPS请求
赵凯月的博客
10-30 1287
我们可以这样认为： 一个URL地址，它用于描述一个网络上的资源，而HTTP中的GET，POST，PUT，DELETE就对应着对这个资源的 查，改，增，删 4个操作。HTTP协议传输的数据都是未加密的，也就是明文的，因此使用HTTP协议传输隐私信息非常不安全，为了保证这些隐私数据能加密传输，于是网景公司设计了SSL（Secure Sockets Layer）协议用于对HTTP协议传输的数据进行加密，从而就诞生了HTTPS。1.Get是最常用的方法，通常用于请求服务器发送某个资源，而且应该是安全的和幂等的。
Go语言HTTP接口开发+测试综合案例
Python私教
09-26 1042
目录结构 go.mod module http_demo go 1.16 web.go package main import ( "http_demo/filestring" "log" "net/http" "os" ) // 错误处理器类型，可以处理的HTTP路由处理器就是此类型，参数和返回值一致 type HttpErrorHandler func(writer http.ResponseWriter, request *http.Request) error // HTTP错
Golang：发起http请求-GET带参数、POST发送Form和JSON数据
最新发布
彭世瑜的博客
05-18 617
通过构建 Request 对象，设置请求头属性import ("fmt""io""net/http"响应},参考：Go实现 简单http请求(get ,post) 多种请求方式。
golang中发送http请求的几种常见情况
diemoyi5954的博客
07-19 1228
整理一下golang中各种http的发送方式 最初的一些项目中，很多的地方都使用到了golang发送http请求，之后再对请求收到的结果进行一些处理，所用到的模式也比较固定，这里整理一下集中http的发送方式，先记录这么多，再一点一点添加。 最基本的场景 方式一 使用http.Newrequest 先生成http.client -> 再生成 http.request -> 之...
Go语言之接口（接口实现条件，使用，原理，类型断言）
Sheena997的博客
03-17 4317
Go语言之接口（接口实现条件，使用，原理，类型断言）
golang http 服务器的接口梳理
weixin_30799995的博客
05-11 297
golang http 服务器的接口梳理 Golang构建HTTP服务（二）--- Handler，ServeMux与中间件 Hanlde和HandleFunc以及Handler, HandlerFunc func Handle(pattern string, handler Handler) // Handle 函数将pattern和对应的handler注册进DefaultServeMux ...
GO 接口详解
baidu_41917849的博客
02-25 2508
在go语言中，接口是一种就是一种类型。同map、struct等的定义，语法是一样。 如： type People interface { Speak(string) string } 关键字是interface。此时就称People是一个接口。 接口的作用就是定义一些对象的共同特征，特征以接口内的方法来定义。如上例的speak方法。 具有上述特征的类型，那就称它实现了这个接口。语法如下： // 定义类型Student，它是一种struct类型 type Student struct{}
horus:Golang的HTTP请求记录器
05-18
在Golang中，HTTP请求处理是通过标准库"net/http"提供的接口完成的。荷鲁斯扩展了这些功能，提供了额外的日志层，可以在每次请求时捕获并记录关键信息。以下是一些荷鲁斯的核心特性： 1. **请求信息记录**：荷鲁斯...
golang防沉迷实名认证系统接口测试代码(亲测全示例通过)
01-18
本文将深入探讨使用Golang编写防沉迷实名认证系统接口的测试代码及其相关知识点。 Golang，也被称为Go语言，是由Google开发的一种静态类型、编译型、并发型且具有垃圾回收功能的编程语言。它以其简洁的语法、高效的...
一些前端和golang练习代码
06-07
这里的“ui-study”文件可能包含了各种前端框架（如React、Vue或Angular）的学习项目，或者关于响应式设计、交互式元素、动画效果和用户体验优化的代码示例。 2. **Golang**：Golang，又称Go语言，由Google开发，以...
Golang 调用http 文件上传接口 进行上传文件
ZaberyJava的博客
04-02 7082
远程服务器有一个文件上传接口，文件用于保存到服务器本地，用go如何调用此接口将文件上传至服务器？ 首先，文件上传请求方 与 接收方 要协调工作（解析等工作） 接收方： func UploadFileToLocal(c echo.Context) error { r := c.Request() //无论用的什么路由，原理是要从request获取数据 t := echotools....
go对接接口
qq_37029718的博客
01-18 2154
前言：这是第一次使用go语言对接接口，记录一下碰到了那些知识。接口需求文档只有两个接口，一个是获取token，在header中使用；另一个是添加订单接口；大致意思就是从我这的系统中读取数据，到，对方的系统中。 目前我只看过go的入门语法，包只认识几个的情况下 go mod一个好用的包版本管理程序，可以让你的go项目放在电脑的任何文件夹下，从gopath/src下解放出来 sqlx的使用 结构体的...
Go语言之Golang http请求库HttpRequest
热门推荐
贤冰的博客
05-11 4万+
Go语言HttpRequest项目源码地址：https://github.com/kirinlabs/HttpRequest 主要实现功能 目录 安装： 发送请求 传递URL参数 响应内容 Json响应内容 定制请求头 BasicAuth 认证 JSON请求 Cookie 超时 关闭证书验证 调试模式 连接操作 Respone对象 实例代码 具有快速构建...
golang 实现http请求测试代码示例
宁静致远的博客
05-10 2651
server端： package main import ( "net/http" "fmt" "io/ioutil" ) func IndexHandler(w http.ResponseWriter, req *http.Request) { fmt.Println("-------------------") fmt.Println(w, "hello world...
golang http请求示例
chengxusuan1296的博客
04-09 97
这个我忘记是哪位大神哪里抄的代码，觉得很好就保留在这里，自己用的时候好参考 package demo import ( "fmt" "io/ioutil" "net/http" "net/url" "strings" ) func HttpGet() { resp,err...
golong 调用http/https接口，使用net/http包写好的几个函数
运维玄德公
05-02 708
文章目录1. go 调用https接口1.1 返回json（完整示例）1.2 只返回code2. get 调用https接口3. put调用https接口 1. go 调用https接口 1.1 返回json（完整示例） package main import ( "bytes" "crypto/tls" "encoding/json" "fmt" "io/ioutil" "net/http" "time" ) func main() { //定义一个结构体传参 var body st
golang gin 统计接口请求流量 代码
03-20
可以使用gin的中间件来统计接口请求流量，以下是示例代码： ```go package main import ( "fmt" "github.com/gin-gonic/gin" ) func main() { r := gin.Default() // 定义中间件 r.Use(func(c *gin.Context) { // 统计请求流量 fmt.Println("请求流量统计：", c.Request.URL.Path) c.Next() }) // 定义路由 r.GET("/hello", func(c *gin.Context) { c.JSON(200, gin.H{ "message": "Hello World!", }) }) // 启动服务 r.Run(":8080") } ``` 在这个示例中，我们定义了一个中间件来统计请求流量，每次请求时都会输出请求的URL路径。然后定义了一个路由，返回一个JSON格式的"Hello World!"消息。最后启动服务，监听8080端口。 当我们访问http://localhost:8080/hello时，控制台会输出以下信息： ``` 请求流量统计： /hello ``` 这样就完成了接口请求流量的统计。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值