httparty

Makes http fun again!

Table of contents

• Parsing JSON
• Working with SSL

Parsing JSON

If the response Content Type is application/json, HTTParty will parse the response and return Ruby objects such as a hash or array. The default behavior for parsing JSON will return keys as strings. This can be supressed with the format option. To get hash keys as symbols:

response = HTTParty.get('http://example.com', format: :plain)
JSON.parse response, symbolize_names: true

Working with SSL

You can use this guide to work with SSL certificates.

Using pem option

# Use this example if you are using a pem file

class Client
    include HTTParty

    base_uri "https://example.com"
    pem File.read("#{File.expand_path('.')}/path/to/certs/cert.pem"), "123456"

end

Using pkcs12 option

# Use this example if you are using a pkcs12 file

class Client
    include HTTParty

    base_uri "https://example.com"
    pkcs12 File.read("#{File.expand_path('.')}/path/to/certs/cert.p12"), "123456"

end

Using ssl_ca_file option

# Use this example if you are using a pkcs12 file

class Client
    include HTTParty

    base_uri "https://example.com"
    ssl_ca_file "#{File.expand_path('.')}/path/to/certs/cert.pem"

end

Using ssl_ca_path option

# Use this example if you are using a pkcs12 file

class Client
    include HTTParty

    base_uri "https://example.com"
    ssl_ca_path '/path/to/certs'
end

You can also include this options with the call:

class Client
    include HTTParty

    base_uri "https://example.com"

    def self.fetch
        get("/resources", pem: (File.read("#{File.expand_path('.')}/path/to/certs/cert.pem"), "123456")
    end
end

Avoid SSL verification

In some cases you may want to skip SSL verification, because the entity that issue the certificate is not a valid one, but you still want to work with it. You can achieve this through:

#Skips SSL certificate verification

class Client
    include HTTParty

    base_uri "https://example.com"
    pem File.read("#{File.expand_path('.')}/path/to/certs/cert.pem"), "123456"

    def self.fetch
        get("/resources", verify: false)
        # You can also use something like:
        # get("resources", verify_peer: false)
    end
end