💎一站式轻松地调用各大LLM模型接口,支持GPT4、智谱、星火、月之暗面及文生图 广告
通常的业务需求都会有请求http服务的需求,包括数据爬虫、接口服务请求等等,该工具能提供一个高效易用的http请求客户端,支持 cookie 保持,能方便的实现模拟登陆请求,链式操作方便进行参数配置。 ## 快速开始 通过如下方式,能快速发送一个 GET 请求 ~~~ client:=httpclient.NewClient() resp,_:=client.RunGet("http://www.baidu.com") ~~~ ## POST 请求 通过如下方式,能快速发送一个 POST 请求 ~~~ client:=httpclient.NewClient() resp,_:=client.RunPost("http://www.baidu.com") ~~~ 通常情况下 POST 请求都会有请求参数,通过如下方式添加 POST 参数 ### 方法1 使用 `FormParams` 方法配置一个 `map[string]interface{}` 参数; 默认 Orange 会以 `application/x-www-form-urlencoded` 的方式发送 POST 请求; 通过 `WithJsonRequest` / `WithFormRequest` 方法可以修改请求头中的文档类型; ~~~ client:=httpclient.NewClient() resp,_:=client.FormParams(map[string]interface{}{ "auth":123, }).RunPost("http://127.0.0.1/test.php?s=1") // 以json的方式发送请求,会将post转换成 {"auth":123} resp,_:=client.WithJsonRequest().FormParams(map[string]interface{}{ "auth":123, }).RunPost("http://127.0.0.1/test.php?s=1") // 以表单提交的方式发送请求 resp,_:=client.WithJsonRequest().FormParams(map[string]interface{}{ "auth":123, }).RunPost("http://127.0.0.1/test.php?s=1") ~~~ ### 方法2 一种更为灵活的方法来发送 POST 参数; ~~~ // 通过 ContentType 配置请求头文档类型 client:=httpclient.NewClient().ContentType("application/json") // 通过 WithBody 添加请求 Body 中的信息 resp,_:=client.WithBody(`{"auth":123}`).RunPost("http://127.0.0.1/test.php?s=1") ~~~ ## 更多配置 ### cookie 保持 通过 `WithCookie` 链式方法能像浏览器一样保持 cookie 解决模拟登陆抓包 session/cookie 问题; 注意:每一次调用 `httpclient.NewClient()` 相当于新创建一个浏览器,cookie 保持需要使用同一个 `httpclient.NewClient()` 返回的对象进行操作。 ~~~ client:=httpclient.NewClient().WithCookie() resp,_: = client.RunGet("http://www.baidu.com") resp,_ = client.RunGet("http://www.baidu.com/login") ~~~ ### 设置超时时间 Orange 框架中默认配置的请求超时时间是 10s 可以通过 `SetTimeout` 链式操作进行配置; ~~~ // 设置 3s 的超时时间 client:=httpclient.NewClient().SetTimeout(3) resp,_:=client.RunGet("http://www.baidu.com") ~~~ ### 设置请求头 通过 `Header` 链式操作配置请求头信息; ~~~ client:=httpclient.NewClient().Header("auth", "123") resp,_:=client.RunGet("http://www.baidu.com") ~~~ ### 添加文件 有的时候我们需要向服务端发送一个文件数据,可以通过该方式时间,添加文件后必须使用 POST 请求才能生效,并且添加文件后请求头中的 Content-Type 将会被设置程成`multipart/form-data`,同样也是使用链式操作进行添加 ~~~ client:=httpclient.NewClient().Header("auth", "123") resp,_:=client.WithFile("file", "./storage/1.jpg"). RunPost("http://127.0.0.1:8088/upload") ~~~ ### 关闭KeepAlives 默认情况下客户端请求都是开启了KeepAlives支持的(同时需要服务端也开启KeepAlives),如果需要将客户端的KeepAlives关闭可以使用该方法。 ~~~ client:=httpclient.NewClient().DisableKeepAlives() resp,_:=client.RunGet("http://www.baidu.com") ~~~ ## 响应 Orange 请求接口返回的是一个响应结构体,里面包含原始响应数据,执行时间,等信息; ~~~ client:=httpclient.NewClient() resp,_:=client.RunGet("http://www.baidu.com") // 获取原始 *http.Response fmt.Println(resp.BodyRaw) // 获取响应内容字符类型 fmt.Println(resp.String()) // 获取响应内容 byte 类型 fmt.Println(resp.Body) // 获取 cookie 信息 fmt.Println(resp.CookieData) // 获取请求执行时间 fmt.Println(resp.GetRequestTime()) ~~~