README.md

#Rextro Rextro is a simple api consumer in golang (go) , make api calls easily using this library. Easily read json response values like : response.success if response looks like : {"response" : {"success" : true, "error" : "none" , "code" : "200"}}

See examples below for better understanding and usage.

#Installation

go get -u -v github.com/varver/rextro

#How to Use ?

For example lets say you want to use this api : https://www.mashape.com/imagevision/nudity-recognition-nudity-filter-for-images

The curl request looks like this

curl -X POST --include 'https://nuditysearch.p.mashape.com/nuditySearch/image' \
  -H 'X-Mashape-Key: ad40Z3nH9NmdfgdfgfdgdfgfdgdfgfdgfdgfdgdfgfgAum8J6' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'Accept: application/json' \
  -d 'objecturl=http://i.imgur.com/4hGni1I.jpg' \
  -d 'setting=3'

Json Response looks like this

{
  "version": "config_v8_2014-01-31",
  "message": "SUCCESS",
  "transactionid": "1234",
  "objecturl": "http://i.imgur.com/4hGni1I.jpg",
  "setting": 2,
  "score": 94,
  "classification": "NUDITY"
}

This is how the code will look like to make above call

package main

import (
	"fmt"
	"github.com/varver/rextro"
)

func Mashape(image string, api_key string) {
	req := rextro.NewTequest("https://nuditysearch.p.mashape.com/nuditySearch/image")

	//headers to be sent
	req.Headers["X-Mashape-Key"] = api_key
	req.Headers["Content-Type"] = "application/x-www-form-urlencoded"
	req.Headers["Accept"] = "application/json"

	// parameters to be sent
	req.Body["setting"] = "2"
	req.Body["objecturl"] = image

	// get response as json converted // you can also make 'GET' request instead of 'POST'
	container, err := req.FetchJson("POST")
	if err != nil {
		fmt.Println(err.Error())
		return
	}

	fmt.Println(container.String())

	/*
		// use this to get raw response as byte array
		// byteArray , err := req.Fetch("POST")

		// OR

		// use this to get response as a string
		// respString , err := req.FetchString("POST")

		// The Request is internally done using https://godoc.org/net/http#NewRequest
	*/

	//////////////////////////////////////////////////////////////////
	/// Lets fetch json values from Response looks like this ////////
	/////////////////////////////////////////////////////////////////
	/*
		{
		  "version": "config_v8_2014-01-31",
		  "message": "SUCCESS",
		  "transactionid": "1234",
		  "objecturl": "http://i.imgur.com/4hGni1I.jpg",
		  "setting": 2,
		  "score": 94,
		  "classification": "NUDITY"
		}
	*/

	message := container.Path("message").Data().(string)
	if message == "SUCCESS" {
		fmt.Println(container.Path("classification").Data().(string))
	} else {
		fmt.Print("Something went wrong")
	}

}

func main() {
	key := "YOUR_API_KEY"
	image_url := "http://i.imgur.com/4hGni1I.jpg"
	Mashape(image_url, key)
}

#Note The package internally uses : https://github.com/Jeffail/gabs to parse json , you can refer its godoc here : https://godoc.org/github.com/Jeffail/gabs to do more stuff on FetchJson output , as it returns the Container of gabs package.