In the official focumentation is very well explained almost every method.
For example in the online API ( or using 'ri Net::HTTP#post' ) :
QUOTE
post(path, data, initheader = nil, dest = nil) {|+body_segment+| ...}
Posts data (must be a String) to path. header must be a Hash like { ‘Accept’ => ’*/*’, … }.
In version 1.1 (ruby 1.6), this method returns a pair of objects, a Net::HTTPResponse object and an entity body string. In version 1.2 (ruby 1.8), this method returns a Net::HTTPResponse object.
If called with a block, yields each fragment of the entity body in turn as a string as it are read from the socket. Note that in this case, the returned response object will not contain a (meaningful) body.
dest argument is obsolete. It still works but you must not use it.
In version 1.1, this method might raise an exception for 3xx (redirect). In this case you can get an HTTPResponse object by "anException.response". In version 1.2, this method never raises exception.
This post has been edited by MitkOK: 10 Oct, 2008 - 09:32 PM