host2ip

A tiny HTTP API server that resolves hostname IP addresses

API

List of available API calls:

• / - shows available junctions
• /lookup/:name - fetches a list of IP addresses for the specified FQDN or hostname
• /lookups - fetches IP addresses for multiple hostnames

Usage

To start the service on [::1]:7029 run:

go run main.go

The server is now accessible at http://localhost:7029.

Example query:

curl -s http://localhost:7029/lookup/google.bg | jq

{
  "addresses": [
    "172.217.16.131",
    "2a00:1450:4001:808::2003"
  ]
}

Example multiple hostname query:

curl -s http://localhost:7029/lookups?host=google.bg&host=github.com | jq

{
  "google.bg": {
    "addresses": [
      "172.217.16.131",
      "2a00:1450:4001:808::2003"
    ]
  },
  "github.com": {
    "addresses": [
      "140.82.113.4",
      "140.82.113.5",
      "140.82.113.6",
      "140.82.113.7"
    ]
  }
}

When using a key via the -apikey parameter the query would look like:

curl -s http://localhost:7029/lookup/google.bg?key=YOUR_KEY | jq

Run on Docker

To create and install a Docker image called github.com/petarov/host2ip-api run:

make build-docker

To run the container run:

make run-docker

License

MIT