The aim of httr is to provide a wrapper for RCurl that is less configurable but customised to the demands of modern web APIs.
functions for the most important http verbs:
automatic connection sharing across requests to the same website (by default, curl handles are managed automatically), cookies are maintained across requests, and the standard root-level SSL certificate store is used.
a request object which captures the body of the request along with http status code, cookies, headers, timings and other useful information.
response content is available with
content()as a raw vector (
as = "raw"), a character vector (
as = "text"), or parsed into an R object (
as = "parsed"), currently for html, xml, json, png and jpeg).
convert http errors into R errors with
wrapper functions for the most common configuration options:
url parsing (with
parse_url) and modification (with
support for OAuth 1.0 and 2.0 with
oauth2.0_token(). The demos directory has six demos of using OAuth: two for 1.0 (twitter and vimeo) and four for 2.0 (facebook, github, google, linkedin). OAuth credentials are automatically cached for each project.
To get the current released version from CRAN:
To get the current development version from github:
# install.packages("devtools") devtools::install_github("hadley/httr")