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
