99 lines
2.1 KiB
Markdown
99 lines
2.1 KiB
Markdown
# httplib
|
|
|
|
httplib is an libs help you to curl remote url.
|
|
|
|
# How to use?
|
|
|
|
## GET
|
|
|
|
you can use Get to crawl data.
|
|
|
|
import "github.com/beego/beego/v2/client/httplib"
|
|
|
|
str, err := httplib.Get("http://beego.me/").String()
|
|
if err != nil {
|
|
// error
|
|
}
|
|
fmt.Println(str)
|
|
|
|
## POST
|
|
|
|
POST data to remote url
|
|
|
|
req := httplib.Post("http://beego.me/")
|
|
req.Param("username","astaxie")
|
|
req.Param("password","123456")
|
|
str, err := req.String()
|
|
if err != nil {
|
|
// error
|
|
}
|
|
fmt.Println(str)
|
|
|
|
## Set timeout
|
|
|
|
The default timeout is `60` seconds, function prototype:
|
|
|
|
SetTimeout(connectTimeout, readWriteTimeout time.Duration)
|
|
|
|
Example:
|
|
|
|
// GET
|
|
httplib.Get("http://beego.me/").SetTimeout(100 * time.Second, 30 * time.Second)
|
|
|
|
// POST
|
|
httplib.Post("http://beego.me/").SetTimeout(100 * time.Second, 30 * time.Second)
|
|
|
|
## Debug
|
|
|
|
If you want to debug the request info, set the debug on
|
|
|
|
httplib.Get("http://beego.me/").Debug(true)
|
|
|
|
## Set HTTP Basic Auth
|
|
|
|
str, err := Get("http://beego.me/").SetBasicAuth("user", "passwd").String()
|
|
if err != nil {
|
|
// error
|
|
}
|
|
fmt.Println(str)
|
|
|
|
## Set HTTPS
|
|
|
|
If request url is https, You can set the client support TSL:
|
|
|
|
httplib.SetTLSClientConfig(&tls.Config{InsecureSkipVerify: true})
|
|
|
|
More info about the `tls.Config` please visit http://golang.org/pkg/crypto/tls/#Config
|
|
|
|
## Set HTTP Version
|
|
|
|
some servers need to specify the protocol version of HTTP
|
|
|
|
httplib.Get("http://beego.me/").SetProtocolVersion("HTTP/1.1")
|
|
|
|
## Set Cookie
|
|
|
|
some http request need setcookie. So set it like this:
|
|
|
|
cookie := &http.Cookie{}
|
|
cookie.Name = "username"
|
|
cookie.Value = "astaxie"
|
|
httplib.Get("http://beego.me/").SetCookie(cookie)
|
|
|
|
## Upload file
|
|
|
|
httplib support mutil file upload, use `req.PostFile()`
|
|
|
|
req := httplib.Post("http://beego.me/")
|
|
req.Param("username","astaxie")
|
|
req.PostFile("uploadfile1", "httplib.pdf")
|
|
str, err := req.String()
|
|
if err != nil {
|
|
// error
|
|
}
|
|
fmt.Println(str)
|
|
|
|
See godoc for further documentation and examples.
|
|
|
|
* [godoc.org/github.com/beego/beego/v2/client/httplib](https://godoc.org/github.com/beego/beego/v2/client/httplib)
|