aboutsummaryrefslogtreecommitdiffstats
path: root/modules/httplib/README.md
blob: 95a10d867704f960516bbaa16017d199bc6c57c3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# httplib
httplib is an libs help you to curl remote url.

# How to use?

## GET
you can use Get to crawl data.

	import "httplib"
	
	str, err := httplib.Get("http://beego.me/").String()
	if err != nil {
		t.Fatal(err)
	}
	fmt.Println(str)
	
## POST
POST data to remote url

	b:=httplib.Post("http://beego.me/")
	b.Param("username","astaxie")
	b.Param("password","123456")
	str, err := b.String()
	if err != nil {
		t.Fatal(err)
	}
	fmt.Println(str)

## set timeout
you can set timeout in request.default is 60 seconds.

set Get timeout:

	httplib.Get("http://beego.me/").SetTimeout(100 * time.Second, 30 * time.Second)
	
set post timeout:	
	
	httplib.Post("http://beego.me/").SetTimeout(100 * time.Second, 30 * time.Second)

- first param is connectTimeout.
- second param is readWriteTimeout

## debug
if you want to debug the request info, set the debug on

	httplib.Get("http://beego.me/").Debug(true)
	
## support HTTPS client
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 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)