danielwestendorf/dnsimpler

A Simple DNSimple API wrapper which always provides the response you're looking for

Dnsimpler

A simple API wrapper for DNSimple. Always returns the full response. Requires you to use the API documentation.

Installation

Add this line to your application's Gemfile:

gem 'dnsimpler'

And then execute:

$ bundle

Or install it yourself as:

$ gem install dnsimpler

Usage

Configure the gem

DNSimpler.setup do |config|
    config.token = "DNSIMPLE_API_TOKEN"
    config.base_uri = "https://api.dnsimple.com/" # For testing you can use the sandbox
    config.debug = false
    config.proxy = {addr: 'http://example.com', port: 8080, user: 'bob', pass: 'password'}
end

Make your API calls.

domains_response = DNSimpler.get('domains')
p domains_response.code
=> 200
p domains_response.body
[ { domain: { ... } }, { domain: { ... } } ]

Some API calls require parameters. Just pass them as a hash

registration = DNSimpler.post('domains/registrar/example.com/register', {registrant_id: 1234})
p registration.code
=> 201
p domains_response.body
{ domain: { name: 'example.com', .... } }

Contributing

1. Fork it ( https://github.com/[my-github-username]/dnsimpler/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request