Perform a request

After preparing a request, call req_perform() to perform it, fetching the results back to R as a response.

req_perform(
  req,
  path = NULL,
  verbosity = getOption("httr2_verbosity", 0L),
  mock = getOption("httr2_mock", NULL)
)

Arguments

req

A request.

path

Optionally, path to save body of request. This is useful for large responses since it avoids storing the response in memory.

verbosity

How much information to print? This is a wrapper around req_verbose() that uses an integer to control verbosity:

• 0: no output

• 1: show headers

• 2: show headers and bodies

• 3: show headers, bodies, and curl status messages.

mock

A mocking function. If supplied, this function is called with the request. It should return either NULL (if it doesn't want to handle the request) or a response (if it does). See with_mock()/ local_mock() for more details.

Value

If request is successful (i.e. the request was successfully performed and a response with HTTP status code <400 was recieved), an HTTP response; otherwise throws an error. Override this behaviour with req_error().

Requests

Note that one call to req_perform() may perform multiple HTTP requests:

• If the url is redirected with a 301, 302, 303, or 307, curl will automatically follow the Location header to the new location.

• If you have configured retries with req_retry() and the request fails with a transient problem, req_perform() will try again after waiting a bit. See req_retry() for details.

• If you are using OAuth, and the cached token has expired, req_perform() will get a new token either using the refresh token (if available) or by running the OAuth flow.

Examples

request("https://google.com") %>%
  req_perform()
#> <httr2_response>
#> GET https://www.google.com/
#> Status: 200 OK
#> Content-Type: text/html
#> Body: In memory (13964 bytes)