jnunemaker /httparty

:tada: Makes http fun again!

★ 5,900⑂ 980👁 59⑃ 454● 427▤ 10
RubyMITCreated 2008-07-28
下载:v0.24.3v0.24.3 ↓0.24.32026-09-30
+0
日增长
5,900
stars
980
forks
59
watchers
454
prs
427
issues
10
releases

README

httparty



Makes http fun again! Ain't no party like a httparty, because a httparty don't stop.

 Install


gem install httparty


 Requirements

- Ruby 2.7.0 or higher
- You like to party!

 Examples

ruby
 Use the class methods to get down to business quickly
response = HTTParty.get('https://api.stackexchange.com/2.2/questions?site=stackoverflow')

puts response.body, response.code, response.message, response.headers.inspect

 Or wrap things up in your own class
class StackExchange
  include HTTParty
  base_uri 'api.stackexchange.com'

  def initialize(service, page)
    @options = { query: { site: service, page: page } }
  end

  def questions
    self.class.get("/2.2/questions", @options)
  end

  def users
    self.class.get("/2.2/users", @options)
  end
end

stack_exchange = StackExchange.new("stackoverflow", 1)
puts stack_exchange.questions
puts stack_exchange.users


See the examples directory for even more goodies.

 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 "https://api.stackexchange.com/2.2/questions?site=stackoverflow"


 Help and Docs

- Docs
- https://github.com/jnunemaker/httparty/discussions
- https://www.rubydoc.info/github/jnunemaker/httparty

 Contributing

- Fork the project.
- Run bundle
- Run bundle exec rake
- 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.
- Run bundle exec rake (No, REALLY :))
- 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.

Top issues

Discussions

Latest release

v0.24.3 v0.24.3 2026-09-30
Full Changelog: https://github.com/jnunemaker/httparty/compare/v0.24.2...v0.24.3

 Bug Fixes

- Support the json gem 3.x, which removed the quirks_mode parser option. (846)
- Fix the MultiXml deprecation warning with multi_xml 0.9+. (838, thanks @robzolkos)
- A UTF-8 byte order mark (BOM) is now stripped from responses that don't declare a charset. Before, a BOM-prefixed JSON response without a charset raised JSON::ParserError. (852)
- A response body that is only a BOM, or a BOM followed by whitespace, now parses to nil like any other blank body, instead of raising or returning the whitespace

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON