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. Use
oauth2.0_tokento get user tokens, and
sign_oauth2.0to sign requests. The demos directory has six demos of using OAuth: three for 1.0 (linkedin, twitter and vimeo) and three for 2.0 (facebook, github, google).
To get the current released version from CRAN:
To get the current development version from github:
# install.packages("devtools") devtools::install_github("hadley/httr")