介绍

在 Go 语言中，RESTful API 是非常流行的一种网络通信方式。而 Go Resty 是一款非常优秀的 RESTful API 客户端库，它提供了简单易用的 API，可以帮助开发者轻松地发送 HTTP 请求和处理响应。本文将详细介绍 Go Resty 的使用方法和常见应用场景。

安装

使用 Go Resty 非常简单，只需要使用 go get 命令安装即可：

1
go get github.com/go-resty/resty/v2

使用

使用 Go Resty 发送 HTTP 请求非常简单，只需要创建一个 Resty 对象，然后使用其提供的方法即可。下面是一个简单的例子：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
package main

import (
    "fmt"
    "github.com/go-resty/resty/v2"
)

func main() {
    // 创建一个 Resty 对象
    client := resty.New()

    // 发送 GET 请求
    resp, err := client.R().
        Get("https://httpbin.org/get")

    // 处理响应
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(resp.String())
}

上面的代码中，我们首先创建了一个 Resty 对象，然后使用其提供的 R() 方法创建一个 Request 对象，最后通过 Get() 方法发送 GET 请求。发送请求后，我们可以通过 resp 对象获取响应数据。

请求

使用 Go Resty 发送 HTTP 请求非常灵活，支持 GET、POST、PUT、PATCH、DELETE 等常见请求方法。下面是一些常见的请求示例：

GET 请求

1
2
3
resp, err := client.R().
    SetQueryParam("key", "value").
    Get("https://httpbin.org/get")

POST 请求

1
2
3
4
resp, err := client.R().
    SetHeader("Content-Type", "application/json").
    SetBody(`{"name":"john", "age":30}`).
    Post("https://httpbin.org/post")

PUT 请求

1
2
3
4
resp, err := client.R().
    SetHeader("Content-Type", "application/json").
    SetBody(`{"name":"john", "age":30}`).
    Put("https://httpbin.org/put")

PATCH 请求

1
2
3
4
resp, err := client.R().
    SetHeader("Content-Type", "application/json").
    SetBody(`{"name":"john", "age":30}`).
    Patch("https://httpbin.org/patch")

DELETE 请求

1
2
resp, err := client.R().
    Delete("https://httpbin.org/delete")

响应

使用 Go Resty 处理响应也非常方便，可以通过 resp 对象获取响应数据，并且支持自动解析 JSON 数据。下面是一些常见的响应处理示例：

获取响应状态码

1
fmt.Println(resp.StatusCode())

获取响应头部信息

1
fmt.Println(resp.Header())

获取响应体数据

1
fmt.Println(resp.Body())

解析 JSON 响应数据

1
2
3
4
5
6
7
var result map[string]interface{}
err = json.Unmarshal(resp.Body(), &result)
if err != nil {
    fmt.Println(err)
    return
}
fmt.Println(result)

高级用法

除了基本的请求和响应处理，Go Resty 还提供了一些高级用法，例如连接池、超时设置、重试机制、代理等。下面是一些常见的高级用法示例：

连接池

1
2
3
4
client := resty.New().
    SetTransport(&http.Transport{
        MaxIdleConnsPerHost: 10,
    })

超时设置

1
2
client := resty.New().
    SetTimeout(10 * time.Second)

重试机制

1
2
3
client := resty.New().
    SetRetryCount(3).
    SetRetryWaitTime(5 * time.Second)

代理

1
2
client := resty.New().
    SetProxy("http://proxy.example.com:8080")

总结

Go Resty 是一款非常优秀的 RESTful API 客户端库，提供了简单易用的 API，可以帮助开发者轻松地发送 HTTP 请求和处理响应。本文介绍了 Go Resty 的基本用法和常见应用场景，并且介绍了一些高级用法，希望可以帮助大家更好地使用 Go Resty。