httpwrapper

httpwrapper

HTTP client wrapper using h2non/gentleman

Quick Usage

package main

import (
	"time"

	// automatically set debug flag (output HTTP request/response to stdout)
	//  _ "github.com/evalphobia/httpwrapper/debug"
	"github.com/evalphobia/httpwrapper/request"
)

func main() {
	// Example #1
	// GET request
	resp, err := request.GET("http://example.com", request.Option{
		Headers: map[string]string{"x-example-token": "abcdefg"},
		Timeout: 10 * time.Second,
		Retry:   true,
		// output HTTP request/response
		Debug: false,
		// for basic auth
		User:  "MyName",
		Pass:  "secret",
		Query: "name=MyName&pass=secret",
		// Query: map[string]string{"name": "MyName", "pass": "secret"},
	})
	if err != nil {
		panic(err)
	}
	// if status code is not 2xx.
	if err := resp.HasStatusCodeError(); err != nil {
		panic(err)
	}

	// for JSON response
	user := User{}
	err = resp.JSON(&user)
	if err != nil {
		panic(err)
	}

	// for XML response
	err = resp.XML(&user, nil)
	if err != nil {
		panic(err)
	}

	// Example #2
	// POST request and set response result.
	user = User{}
	err = request.CallWithResult(request.Option{
		URL:         "http://example.com",
		Method:      request.MethodPOST,
		PayloadType: request.PayloadTypeJSON,
		Payload:     map[string]interface{}{"param1": 100, "param2": "abc"},
	}, &user)
	if err != nil {
		panic(err)
	}

	// ...
}

// struct for HTTP response data
type User struct {
	LastName  string `json:"last_name" xml:"last_name"`
	FirstName string `json:"first_name" xml:"first_name"`
	Age       int    `json:"age" xml:"age"`
}

Option