req_options: Set arbitrary curl options in request

In r-lib/httr2: Perform HTTP Requests and Process the Responses

Set arbitrary curl options in request

Description

req_options() is for expert use only; it allows you to directly set libcurl options to access features that are otherwise not available in httr2.

Usage

req_options(.req, ...)

Arguments

.req	A request.
...	<dynamic-dots> Name-value pairs. The name should be a valid curl option, as found in curl::curl_options().

Value

A modified HTTP request.

Examples

# req_options() allows you to access curl options that are not otherwise
# exposed by httr2. For example, in very special cases you may need to
# turn off SSL verification. This is generally a bad idea so httr2 doesn't
# provide a convenient wrapper, but if you really know what you're doing
# you can still access this libcurl option:
req <- request("https://example.com") |>
  req_options(ssl_verifypeer = 0)

r-lib/httr2 documentation built on Jan. 11, 2025, 10:21 a.m.