req_cached: Perform a cached HTTP GET request

In salim-b/pal: Friendly Convenience/Utility Functions

Perform a cached HTTP GET request

Description

Convenience wrapper around a bunch of httr2 functions.

Usage

req_cached(url, max_tries = 3L)

Arguments

url	HTTP protocol address. The scheme is optional, so both "google.com" and "https://google.com" will work. A character scalar.
max_tries	Maximum number of request attempts in case of an HTTP error. An integerish scalar. Retries are performed using exponential backoff and jitter, see httr2::req_retry() for details.

Value

• If the HTTP request succeeds, and the status code is ok (e.g. 200), an HTTP response.

• If the HTTP request succeeds, but the status code is an error (e.g a 404), an error with class c("httr2_http_404", "httr2_http"). By default, all 400 and 500 status codes will be treated as an error, but you can customise this with req_error().

• If the HTTP request fails (e.g. the connection is dropped or the server doesn't exist), an error with class "httr2_failure".

See Also

Other HTTP functions: is_http_success(), is_url()

salim-b/pal documentation built on Feb. 28, 2025, 6:51 p.m.