publicipgrabber

Documentation

Overview

package designed to query api.whatismyip.com for public IP address information. this package contains the structs defining the JSON responses expected and the objects that will utilize them to pull down information.

Index

• Constants
• type AppResponse
• type LocationResponse
• type PublicIPGrabber
  • func NewPublicIPGrabber(optfuncs ...PublicIPGrabberOptFunc) (grabber *PublicIPGrabber, err error)
  • func (ipg *PublicIPGrabber) GetIPInformation(targetip string) (ipinformation *AppResponse, err error)
  • func (ipg *PublicIPGrabber) GetMyIPInformation() (err error)
• type PublicIPGrabberOptFunc
  • func WithClient(client *http.Client) PublicIPGrabberOptFunc
• type PublicIPGrabberOptions
• type PublicIPInfo

Constants

const BASE_URL string = "https://api.whatismyip.com"

base url address for all whatismyip API queries.

Types

type AppResponse

type AppResponse struct {
	// data returned from ip2location.com query made
	// by api.whatismyip.com/app.php.
	Ip2location LocationResponse `json:"ip2location.com"`

	// data returned from ipdata.co query made
	// by api.whatismyip.com/app.php.
	Ipdata LocationResponse `json:"ipdata.co"`
}

structure representing the response from api.whatismyip.com/app.php when querying information related to an IP address.

type LocationResponse

type LocationResponse struct {
	Asn        string `json:"asn"`
	City       string `json:"city"`
	Region     string `json:"region"`
	Country    string `json:"country"`
	PostalCode string `json:"postal_code"`
	Isp        string `json:"isp"`
	TimeZone   string `json:"time_zone"`
}

structure defining the IP2Location and IPData JSON returns from app.php.

type PublicIPGrabber

type PublicIPGrabber struct {

	// information pulled down from api.whatismyip.com.
	PublicIP PublicIPInfo
	// contains filtered or unexported fields
}

structure defining a PublicIPGrabber object. this will have associated functions to query the site api.whatismyip.com and grab the public IP info.

func NewPublicIPGrabber

func NewPublicIPGrabber(optfuncs ...PublicIPGrabberOptFunc) (grabber *PublicIPGrabber, err error)

function designed to create and initialize a new PubliIPGrabber object. the user can pass in option functions to change the configuration.

func (*PublicIPGrabber) GetIPInformation

func (ipg *PublicIPGrabber) GetIPInformation(targetip string) (ipinformation *AppResponse, err error)

function designed to query api.whatismyip.com and get information related to a given IP address.

func (*PublicIPGrabber) GetMyIPInformation

func (ipg *PublicIPGrabber) GetMyIPInformation() (err error)

function designed to query api.whatismyip.com and pull down the public IP address information for the machine executing the program.

type PublicIPGrabberOptFunc

type PublicIPGrabberOptFunc func(*PublicIPGrabberOptions) error

type alias defining the function structure that will be used to set the configuration options for a PublicIPGrabberOptions object.

func WithClient

func WithClient(client *http.Client) PublicIPGrabberOptFunc

function designed to set the PublicIPGrabberOptions client.

type PublicIPGrabberOptions

type PublicIPGrabberOptions struct {
	// http client that will be used to carry
	// out queries to api.whatismyip.com.
	Client *http.Client
}

structure defining the object that will be used to initialize a public ip grabber object.

type PublicIPInfo

type PublicIPInfo struct {
	// public ip address
	Ip string `json:"ip"`

	// geolocation of the server hosting the ip
	Location string `json:"geo"`

	// provider hosting the IP address
	Provider string `json:"isp"`
}

structure holding public ip information. this will be used in the PublicIPGrabber object and associated request to api.whatismyip.com.