Learn R Programming

⚠️There's a newer version (1.4.7) of this package.Take me there.

httr

The aim of httr is to provide a wrapper for the curl package, customised to the demands of modern web APIs.

Key features:

  • 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 a 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.

    • 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.

    • You can convert http errors into R errors with stop_for_status().

  • Config functions make it easier to modify the request in common ways: set_cookies(), add_headers(), authenticate(), use_proxy(), verbose(), timeout(), content_type(), accept(), progress().

  • 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.

httr wouldn't be possible without the hard work of the authors of curl and libcurl. Thanks! httr is inspired by http libraries in other languages, such as Resty, Requests and httparty.

Installation

To get the current released version from CRAN:

install.packages("httr")

To get the current development version from github:

# install.packages("devtools")
devtools::install_github("r-lib/httr")

Code of Conduct

Please note that the httr project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

Copy Link

Version

Install

install.packages('httr')

Monthly Downloads

833,627

Version

1.4.4

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Last Published

August 17th, 2022

Functions in httr (1.4.4)

HEAD

Get url HEADers.
cookies

Access cookies in a response.
get_callback

Install or uninstall a callback function
PATCH

Send PATCH request to a server.
jwt_signature

Generate a JWT signature given credentials.
modify_url

Modify a url.
oauth_endpoints

Popular oauth endpoints.
oauth_endpoint

Describe an OAuth endpoint.
POST

POST file to a server.
add_headers

Add additional headers to a request.
authenticate

Use http authentication.
timeout

Set maximum request time.
handle_pool

Maintain a pool of handles.
upload_file

Upload a file with POST() or PUT().
httr_options

List available options.
init_oauth1.0

Retrieve OAuth 1.0 access token.
has_content

Does the request have content associated with it?
BROWSE

Open specified url in browser.
DELETE

Send a DELETE request.
oauth_exchanger

Walk the user through the OAuth2 dance without a local webserver.
oauth_listener

Create a webserver to listen for OAuth callback.
cache_info

Compute caching information for a response.
config

Set curl options.
http_condition

Generate a classed http condition.
set_config

Set (and reset) global httr configuration.
http_error

Check for an http error.
set_cookies

Set cookies.
oauth_app

Create an OAuth application.
verbose

Give verbose output.
with_config

Execute code with configuration set.
oauth_callback

The oauth callback url.
parse_http_date

Parse and print http dates.
parse_media

Parse a media type.
Token-class

OAuth token objects.
VERB

VERB a url.
guess_media

Guess the media type of a path from its extension.
response

The response object.
revoke_all

Revoke all OAuth tokens in the cache.
handle

Create a handle tied to a particular host.
headers

Extract the headers from a response
PUT

Send PUT request to server.
RETRY

Retry a request until it succeeds.
httr-package

httr makes http easy.
hmac_sha1

HMAC SHA1
httr_dr

Diagnose common configuration problems
parse_url

Parse and build urls according to RFC3986.
progress

Add a progress bar.
oauth1.0_token

Generate an oauth1.0 token.
content

Extract content from a request.
oauth2.0_token

Generate an oauth2.0 token.
sha1_hash

SHA1 hash
status_code

Extract status code from response.
sign_oauth

Sign an OAuth request
content_type

Set content-type and accept headers.
http_status

Give information on the status of a request.
use_proxy

Use a proxy to connect to the internet.
user_agent

Set user agent.
http_type

Extract the content type of a response
init_oauth2.0

Retrieve OAuth 2.0 access token.
stop_for_status

Take action on http error.
write_stream

Process output in a streaming manner.
insensitive

Create a vector with case insensitive name matching.
oauth_service_token

Generate OAuth token for service accounts.
oauth_signature

Generate oauth signature.
write_disk

Control where the response body is written.
write_function

S3 object to define response writer.
GET

GET a url.