Returns the address of the proxy host, or nil if none; see Net::HTTP@Proxy+Server.

Returns true if self is a class which was created by HTTP::Proxy.

Returns the password for accessing the proxy, or nil if none; see Net::HTTP@Proxy+Server.

Returns the port number of the proxy host, or nil if none; see Net::HTTP@Proxy+Server.

Use SSL when talking to the proxy. If ::Net::HTTP does not use a proxy, nil.

Returns the user name for accessing the proxy, or nil if none; see Net::HTTP@Proxy+Server.

Sends a GET request and returns the HTTP response body as a string.

With string arguments hostname and path:

hostname = 'jsonplaceholder.typicode.com'
path = '/todos/1'
puts Net::HTTP.get(hostname, path)

Output:

{
"userId": 1,
"id": 1,
"title": "delectus aut autem",
"completed": false
}

With URI object uri and optional hash argument headers:

uri = URI('https://jsonplaceholder.typicode.com/todos/1')
headers = {'Content-type' => 'application/json; charset=UTF-8'}
Net::HTTP.get(uri, headers)

Related:

• Get: request class for HTTP method GET.
• Net::HTTP#get: convenience method for HTTP method GET.

Like Net::HTTP.get, but writes the returned body to $stdout; returns nil.

Like Net::HTTP.get, but returns a ::Net::HTTPResponse object instead of the body string.

Returns integer 80, the default port to use for HTTP requests:

Net::HTTP.http_default_port # => 80

Returns integer 443, the default port to use for HTTPS requests:

Net::HTTP.https_default_port # => 443

Posts data to a host; returns a ::Net::HTTPResponse object.

Argument url must be a URL; argument data must be a string:

_uri = uri.dup
_uri.path = '/posts'
data = '{"title": "foo", "body": "bar", "userId": 1}'
headers = {'content-type': 'application/json'}
res = Net::HTTP.post(_uri, data, headers) # => #<Net::HTTPCreated 201 Created readbody=true>
puts res.body

Output:

{
"title": "foo",
"body": "bar",
"userId": 1,
"id": 101
}

Related:

• Post: request class for HTTP method POST.
• Net::HTTP#post: convenience method for HTTP method POST.

Posts data to a host; returns a ::Net::HTTPResponse object.

Argument url must be a URI; argument data must be a hash:

_uri = uri.dup
_uri.path = '/posts'
data = {title: 'foo', body: 'bar', userId: 1}
res = Net::HTTP.post_form(_uri, data) # => #<Net::HTTPCreated 201 Created readbody=true>
puts res.body

Output:

{
"title": "foo",
"body": "bar",
"userId": "1",
"id": 101
}

Creates an HTTP proxy class which behaves like Net::HTTP, but performs all access via the specified proxy.

This class is obsolete. You may pass these same parameters directly to Net::HTTP.new. See Net::HTTP.new for details of the arguments.

Sends a PUT request to the server; returns a ::Net::HTTPResponse object.

Argument url must be a URL; argument data must be a string:

_uri = uri.dup
_uri.path = '/posts'
data = '{"title": "foo", "body": "bar", "userId": 1}'
headers = {'content-type': 'application/json'}
res = Net::HTTP.put(_uri, data, headers) # => #<Net::HTTPCreated 201 Created readbody=true>
puts res.body

Output:

{
"title": "foo",
"body": "bar",
"userId": 1,
"id": 101
}

Related:

• Put: request class for HTTP method PUT.
• Net::HTTP#put: convenience method for HTTP method PUT.

obsolete

Creates a new Net::HTTP object, http, via Net::HTTP.new:

• For arguments Net::HTTP#address and Net::HTTP#port, see Net::HTTP.new.
• For proxy-defining arguments p_addr through p_pass, see Proxy Server.
• For argument opts, see below.

With no block given:

• Calls http.start with no block (see Net::HTTP#start), which opens a TCP connection and HTTP session.
• Returns http.
• The caller should call Net::HTTP#finish to close the session:

http = Net::HTTP.start(hostname) http.started? # => true http.finish http.started? # => false

With a block given:

• Calls http.start with the block (see Net::HTTP#start), which:

• Opens a TCP connection and HTTP session.

• Calls the block, which may make any number of requests to the host.

• Closes the HTTP session and TCP connection on block exit.

• Returns the block's value object.

• Returns object.

Example:

hostname = 'jsonplaceholder.typicode.com'
Net::HTTP.start(hostname) do |http|
puts http.get('/todos/1').body
puts http.get('/todos/2').body
end

Output:

{
"userId": 1,
"id": 1,
"title": "delectus aut autem",
"completed": false
}
{
"userId": 1,
"id": 2,
"title": "quis ut nam facilis et officia qui",
"completed": false
}

If the last argument given is a hash, it is the opts hash, where each key is a method or accessor to be called, and its value is the value to be set.

The keys may include:

• Net::HTTP#ca_file
• Net::HTTP#ca_path
• Net::HTTP#cert
• Net::HTTP#cert_store
• Net::HTTP#ciphers
• Net::HTTP#close_on_empty_response
• Net::HTTP#ipaddr (calls Net::HTTP#ipaddr=)
• Net::HTTP#keep_alive_timeout
• Net::HTTP#key
• Net::HTTP#open_timeout
• Net::HTTP#read_timeout
• Net::HTTP#ssl_timeout
• Net::HTTP#ssl_version
• use_ssl (calls Net::HTTP#use_ssl=)
• Net::HTTP#verify_callback
• Net::HTTP#verify_depth
• Net::HTTP#verify_mode
• Net::HTTP#write_timeout

Note: If Net::HTTP#port is nil and opts is a truthy value, the value passed to .new is Net::HTTP.https_default_port, not Net::HTTP#port.