Build Status

A ruby client library for working with Shortify


gem "shortify"

And then execute:

$ bundle

Or install it yourself as:

$ gem install shortify


def make_short_url(full_url)
  # assumes you're hosting your shortify instance at
  # for SSL, provide the scheme and host. E.g.
  client ="", "username", "password")
rescue Shortify::Error => e
  # do something with the error

Error Types

  • Shortify::AuthenticationError - bad credentials
  • Shortify::ParamsError - bad url parameter
  • Shortify::Error - anything else


After checking out the repo, run bin/setup to install dependencies.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release to create a git tag for the version, push git commits and tags, and push the .gem file to


  1. Fork it ([my-github-username]/shortify/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