J1X/whois-server
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
43 commits 1 branch 0 tags 199 KiB
  • Ruby 39.5%
  • JavaScript 24.5%
  • HTML 22.9%
  • CSS 10.5%
  • Haml 2.6%
Find a file
Exact
James Peret 02b39277c9 cloned project and fixed highlighter bug
2015-08-10 20:06:48 -03:00
public cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
views cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
.gitignore cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
.ruby-version cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
analytics.rb cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
config.ru cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
Gemfile cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
Gemfile.lock cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
json_parser.rb cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
main.rb cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
README.md cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00
unirest_parser.rb cloned project and fixed highlighter bug 2015-08-10 20:06:48 -03:00

README.md

J1X Whois API

A simple WHOIS lookup API.

Based on the Whoiz application by Jason Ormand and using the Ruby Whois gem.

Example Domain Lookup

{
  "domain": "jamesperet.com",
  "owner": "James Peret",
  "registrar": "eNom Inc.",
  "expires_on": "2016-06-07T16:01:00.00Z",
  "update_on": "2015-05-13 00:00:00 -0300",
  "registered?": true,
  "available?": false
}

Accessing the API

Provide a url for the API and get a nicely formatted JSON response with the domain information.

Browser

http://whois.j1x.co
http://whois.j1x.co/lookup.json?url=jamesperet.com

curl

curl http://whois.j1x.co/lookup.json?url=jamesperet.com

Query Options

This are the options for querying the API:

  • url - The domain url that will be queried. Omit the http://www..
  • raw=true - the JSON response will include a raw version of the data received by the registrar
  • dev=true - Only basic information and the raw version will be included in the JSON response. No parsing will be done with the data. This is useful for debugging.

Example:

http://whois.j1x.co/lookup.json?url=google.com&raw=true

Install

Clone

git clone git://gitlab.j1x.co/j1x/whois-server.git

Restrict It

Edit main.rb:

before do
  response['Access-Control-Allow-Origin'] = 'http://yourwebsite.com'
end

Or use * to allow any website to access the API.

Deploy It

heroku create
git push heroku master
heroku open

Domain Support

For now the supported domains are: .com, .net, .com.br and .network. Support for more domains will come in the future.

The queries for .com.br domains usually come with limited information because of the registrar's API call allowance.

There is also a bug where some .com domains return an error (ex: google.com).

Development Resources

Tools

  • Rubular - a Ruby regular expression editor

Articles