httr is superseded: only changes necessary to keep it on CRAN will be made. We recommend using httr2 instead. The aim of httr is to provide a wrapper for the curl package, customized to the demands of modern web APIs. Functions for the most important http verbs: GET(), HEAD(), PATCH(), PUT(), DELETE() and POST(). Automatic connection sharing across requests to the same website (by default, curl handles are managed automatically), cookies are maintained across requests, and an up-to-date root-level SSL certificate store is used. Requests return a standard reponse object that captures the http status line, headers and body, along with other useful information. Support for OAuth 1.0 and 2.0 with oauth1.0_token() and oauth2.0_token(). The demo directory has eight OAuth demos: four for 1.0 (twitter, vimeo, withings and yahoo) and four for 2.0 (facebook, github, google, linkedin). OAuth credentials are automatically cached within a project.

Features

  • Functions for the most important http verbs: GET(), HEAD(), PATCH(), PUT(), DELETE() and POST()
  • Automatic connection sharing across requests to the same website
  • Requests return a standard reponse object that captures the http status line, headers and body, along with other useful information
  • You can convert http errors into R errors with stop_for_status()
  • Config functions make it easier to modify the request in common ways
  • Support for OAuth 1.0 and 2.0 with oauth1.0_token() and oauth2.0_token()

Project Samples

Project Activity

See All Activity >