Provides support to utilise the OpenSRS API with Ruby/Rails.
Switch branches/tags
Nothing to show
Pull request Compare This branch is 83 commits behind voxxit:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Provides basic support to connect to, and utilise the OpenSRS API. This library has been well-tested in a high performance production environment. More information on the API can be located here:


You can install this gem by doing the following:

$ gem install opensrs

You can then include it in a Ruby project, like so:

require 'opensrs'

Alternatively, you can include it in a Rails 2.x project in the environment.rb file, like so:

config.gem "opensrs"

For Rails 3.x, use the Gemfile:

gem "opensrs"


This library provides basic functionality for interacting with the OpenSRS XML API.

  • Connection handling

  • Error reporting

  • XML encoding

  • XML decoding

To connect, instantiate a new OpenSRS::Server object:

server =
  :server   => "",
  :username => "testing",
  :password => "53cr3t",
  :key      => "c633be3170c7fb3fb29e2f99b84be2410..."

Once you have this, you can build from this to create the methods that you need. For instance, let's say we want to grab our account balance. The OpenSRS XML API takes a couple of attributes for all commands. You can include those here:

def get_balance
    :action => "GET_BALANCE",
    :object => "BALANCE"

Sometimes you might need to include attributes for the command, such as a cookie, or the data attributes themselves. You can do this, too:

def create_nameserver(nameserver)
    :action => "CREATE",
    :object => "NAMESERVER",
    :cookie => "366828736:3210384",
    :attributes => {
      :name => nameserver.hostname,
      :ipaddress => ""

Responses from OpenSRS are returned in an OpenSRS::Response object, which gives you access to a multitude of things.

  • response.response - This gives you the response in a Hash form, which is highly accessible to most other actions in your application.

  • response.errors - If there are errors which come back from OpenSRS, they are returned here. If not, it returns nil.

  • response.success? - Returns true if the response was labeled as successful. If not, it returns false.

  • response.request_xml - Returns raw request XML.

  • response.response_xml - Returns raw response XML.

Bugs/Feature Requests

If you have any bugs or feature requests for this gem, feel free to add them in the Issues portion of the GitHub repository here:

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. If you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull.

  • Send me a pull request. Bonus points for topic branches.


Copyright © 2010 Josh Delsman. See LICENSE for details.