Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Makes http fun! Also, makes consuming restful web services dead easy.
Ruby JavaScript

This branch is 512 commits behind jnunemaker:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin Remove dependency of rubygems
examples Fix activesupport deprecation warning
features Fixed missing require which was causing feature failure.
lib Update crack dependency and release 0.6.1.
spec Fix use within ActiveRecord subclasses
website Updated website to point to github issues instead of lighthouse.
.gitignore Yardoc Rake task
MIT-LICENSE Removing .txt from files (it has always annoyed me). Boo Windows!
Manifest Fixed manifest.
Rakefile Update crack dependency and release 0.6.1.
VERSION Version bump to 0.6.0
cucumber.yml Cucumber features and steps for most functionality as of the 0.2.8
httparty.gemspec Regenerated gemspec for version 0.6.1



Makes http fun again!

Note on Releases

Releases are tagged on github and also released as gems on github and rubyforge. Master is pushed to whenever I add a patch or a new feature. To build from master, you can clone the code, generate the updated gemspec, build the gem and install.

  • rake gemspec

  • gem build httparty.gemspec

  • gem install the gem that was built

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 in another branch so I can ignore when I pull)

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


  • Easy get, post requests

  • Basic http authentication

  • Default request query string parameters (ie: for api keys that are needed on each request)

  • Automatic parsing of JSON and XML into ruby hashes based on response content-type



Command Line Interface

httparty also includes the executable httparty which can be used to query web services and examine the resulting output. By default it will output the response as a pretty-printed Ruby object (useful for grokking the structure of output). This can also be overridden to output formatted XML or JSON. Execute httparty --help for all the options. Below is an example of how easy it is.

httparty ""



  • sudo gem install httparty


Something went wrong with that request. Please try again.