Allows setting a base uri to be used for each request. Will normalize uri to include http, etc.

  class Foo
    include HTTParty
    base_uri 'twitter.com'
  end

Allows setting basic authentication username and password.

  class Foo
    include HTTParty
    basic_auth 'username', 'password'
  end

Set an output stream for debugging, defaults to $stderr. The output stream is passed on to Net::HTTP#set_debug_output.

  class Foo
    include HTTParty
    debug_output $stderr
  end

Allows setting default parameters to be appended to each request. Great for api keys and such.

  class Foo
    include HTTParty
    default_params :api_key => 'secret', :another => 'foo'
  end

Allows setting a default timeout for all HTTP calls Timeout is specified in seconds.

  class Foo
    include HTTParty
    default_timeout 10
  end

Perform a DELETE request to a path

Allows setting digest authentication username and password.

  class Foo
    include HTTParty
    digest_auth 'username', 'password'
  end

Allows setting the format with which to parse. Must be one of the allowed formats ie: json, xml

  class Foo
    include HTTParty
    format :json
  end

Allows making a get request to a url.

  class Foo
    include HTTParty
  end

  # Simple get with full url
  Foo.get('http://foo.com/resource.json')

  # Simple get with full url and query parameters
  # ie: http://foo.com/resource.json?limit=10
  Foo.get('http://foo.com/resource.json', :query => {:limit => 10})

Perform a HEAD request to a path

Allows setting HTTP headers to be used for each request.

  class Foo
    include HTTParty
    headers 'Accept' => 'text/html'
  end

Allows setting http proxy information to be used

  class Foo
    include HTTParty
    http_proxy 'http://foo.com', 80
  end

Declare that you wish to maintain the chosen HTTP method across redirects. The default behavior is to follow redirects via the GET method. If you wish to maintain the original method, you can set this option to true.

@example

  class Foo
    include HTTParty
    base_uri 'http://google.com'
    maintain_method_across_redirects true
  end

Declare whether or not to follow redirects. When true, an {HTTParty::RedirectionTooDeep} error will raise upon encountering a redirect. You can then gain access to the response object via HTTParty::RedirectionTooDeep#response.

@see HTTParty::ResponseError#response

@example

  class Foo
    include HTTParty
    base_uri 'http://google.com'
    no_follow true
  end

  begin
    Foo.get('/')
  rescue HTTParty::RedirectionTooDeep => e
    puts e.response.body
  end

Perform an OPTIONS request to a path

Allows setting a custom parser for the response.

  class Foo
    include HTTParty
    parser Proc.new {|data| ...}
  end

Allows setting a PEM file to be used

  class Foo
    include HTTParty
    pem File.read('/home/user/my.pem')
  end

Allows making a post request to a url.

  class Foo
    include HTTParty
  end

  # Simple post with full url and setting the body
  Foo.post('http://foo.com/resources', :body => {:bar => 'baz'})

  # Simple post with full url using :query option,
  # which gets set as form data on the request.
  Foo.post('http://foo.com/resources', :query => {:bar => 'baz'})

Perform a PUT request to a path