httr (version 0.2)

GET: GET a url.

Description

GET a url.

Usage

GET(url = NULL, config = list(), ..., handle = NULL)

Arguments

url

the url of the page to retrieve

...

Further parameters, such as query, path, etc, passed on to modify_url. These parameters must be named.

config

Additional configuration settings such as http authentication (authenticate), additional headers (add_headers), cookies (

handle

The handle to use with this request. If not supplied, will be retrieved and reused from the handle_pool based on the scheme, hostname and port of the url. By default httr requests to

RFC2616

The GET method means retrieve whatever information (in the form of an entity) is identified by the Request-URI. If the Request-URI refers to a data-producing process, it is the produced data which shall be returned as the entity in the response and not the source text of the process, unless that text happens to be the output of the process.

The semantics of the GET method change to a "conditional GET" if the request message includes an If-Modified-Since, If-Unmodified-Since, If-Match, If-None-Match, or If-Range header field. A conditional GET method requests that the entity be transferred only under the circumstances described by the conditional header field(s). The conditional GET method is intended to reduce unnecessary network usage by allowing cached entities to be refreshed without requiring multiple requests or transferring data already held by the client.

The semantics of the GET method change to a "partial GET" if the request message includes a Range header field. A partial GET requests that only part of the entity be transferred, as described in http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35 The partial GET method is intended to reduce unnecessary network usage by allowing partially-retrieved entities to be completed without transferring data already held by the client.

See Also

Other http methods: BROWSE, DELETE, HEAD

Examples

GET("http://google.com/")
GET("http://google.com/", path = "search")
GET("http://google.com/", path = "search", query = c(q = "ham"))

# See what GET is doing with requestb.in
b <- new_bin()
GET(b)
GET(b, add_headers(a = 1, b = 2))
GET(b, set_cookies(a = 1, b = 2))
GET(b, authenticate("username", "password"))
GET(b, verbose())

# You might want to manually specify the handle so you can have multiple
# independent logins to the same website.
google <- handle("http://google.com")
GET(handle = google, path = "/")
GET(handle = google, path = "search")