Net::HTTP#request_post

request_post(path, data, initheader = nil) { |response| ... }

# File tmp/rubies/ruby-3.3.0/lib/net/http.rb, line 2216
def request_post(path, data, initheader = nil, &block) # :yield: +response+
  request Post.new(path, initheader), data, &block
end

Sends a POST request to the server; forms the response into a Net::HTTPResponse object.

The request is based on the Net::HTTP::Post object created from string path, string data, and initial headers hash initheader.

With no block given, returns the response object:

Example

http = Net::HTTP.new(hostname)
http.post('/todos', 'xyzzy')
# => #<Net::HTTPCreated 201 Created readbody=true>

With a block given, calls the block with the response body and returns the response object:

Example

http.post('/todos', 'xyzzy') do |res|
  p res
end # => #<Net::HTTPCreated 201 Created readbody=true>

Output:

Example

"{\n  \"xyzzy\": \"\",\n  \"id\": 201\n}"

See also #request_head #response_body_encoding= #request_get #send_entity also in 4.1 · 4.0 · 3.4 · 3.2 · 3.1 · 3.0

‹ prev#request_head next ›#response_body_encoding=