设置查询参数

在请求级别设置 #

使用 SetQueryParam、SetQueryParams、SetQueryString、AddQueryParam、SetQueryParamsFromValues 或 SetQueryParamsFromStruct 在请求级别追加 URL 查询参数:

client := req.C().EnableDebugLog().EnableDumpAllWithoutResponse()

values := url.Values{}
values.Add("f", "f")
values.Add("g", "g")

type QueryParams struct {
  Name  string `url:"name"`
  Limit int    `url:"limit"`
}
params := QueryParams{
  Name:  "example",
  Limit: 10,
}

client.R().
  SetQueryParam("a", "a").          // Set a query param, which will be encoded as query parameter in url
  SetQueryParams(map[string]string{ // Set multiple query params at once
    "b": "b",
    "c": "c",
  }).
  SetQueryString("d=d&e=e").      // Set query params as a raw query string
  AddQueryParam("key", "value1"). // Add query params with multiple values
  AddQueryParam("key", "value2").
  SetQueryParamsFromValues(values). // Set query params from a url.Values
  SetQueryParamsFromStruct(params). // Set query params from a struct
  Get("https://httpbin.org/get")

2025/09/08 10:04:20.492326 DEBUG [req] HTTP/2 GET https://httpbin.org/get?a=a&b=b&c=c&d=d&e=e&f=f&g=g&key=value1&key=value2&limit=10&name=example
:authority: httpbin.org
:method: GET
:path: /get?a=a&b=b&c=c&d=d&e=e&f=f&g=g&key=value1&key=value2&limit=10&name=example
:scheme: https
accept-encoding: gzip
user-agent: req/v3 (https://github.com/imroc/req)

在客户端级别设置 #

类似的，使用 SetCommonQueryParam、SetCommonQueryParams、SetCommonQueryString、AddCommonQueryParam、SetQueryParamsFromValues 或 SetQueryParamsFromStruct 可以在客户端级别追加 URL 查询参数，对所有请求生效：

client.SetCommonQueryParam("a", "a").
    SetCommonQueryParams(map[string]string{
        "b": "b",
        "c": "c",
    }).
    SetCommonQueryString("d=d&e=e").
    AddCommonQueryParam("key", "value1").
    AddCommonQueryParam("key", "value2").
    SetCommonQueryParamsFromValues(values).
    SetCommonQueryParamsFromStruct(params)

resp1, err := client.Get(url1)
...
resp2, err := client.Get(url2)
...