web

API for making HTTP REST requests.

Usage (plain text)

If you just want the response and it is plain text, use RequestBody.

package thingy

import (
  "github.com/erikbryant/web"
)

body, err := web.RequestBody("https://www.google.com/", {})
if err != nil {
  return err
}

Usage (inspect response)

If you wish to inspect the response object, use Request2.

package thingy

import (
  "github.com/erikbryant/web"
)

body, err := web.Request2("https://www.google.com/", {})
if err != nil {
  return err
}

code := web.ToInt(error["code"])

fmt.Println(code)
// 101

Usage (JSON)

If the response is JSON, use RequestJSON.

package thingy

import (
  "fmt"
  "github.com/erikbryant/web"
)

response, err := web.RequestJSON("https://api.ipstack.com/check", {})
if err != nil {
  return err
}

fmt.Println(response)
// response = {
//   "success": false,
//   "error": {
//     "code": 101,
//     "type": "missing_access_key",
//     "info": "You have not supplied an API Access Key. [Required format: access_key=YOUR_ACCESS_KEY]"
//   }
// }

error := response["error"].([]interface{})[0].(map[string]interface{})
code := web.ToInt(error["code"])

fmt.Println(code)
// 101

Setting Headers

You can pass in a map of headers that you wish to set.

import (
  "fmt"
  "github.com/erikbryant/web"
)

url := "https://www.marinetraffic.com/getData/get_data_json_4/z:14/X:1309/Y:3165/station:0"
headers := map[string]string{
  "user-agent":       "ship-ahoy",
  "x-requested-with": "XMLHttpRequest",
  "vessel-image":     "001609ab6d06a620f459d4a1fd65f1315f11",
}

response, err := web.RequestJSON(url, headers)
if err != nil {
  return err
}

fmt.Println(response)
// response = {
//   "type":1,
//   "data":{
//     "rows":[
//       {"LAT":"37.80998","LON":"-122.4215","SPEED":"0", ...},
//       ...
//     ]
//   }
// }