Create a new HTTP response — response • httr2

Generally, you should not need to call this function directly; you'll get a real HTTP response by calling req_perform() and friends. This function is provided primarily for testing, and a place to describe the key components of a response.

Usage

response(
  status_code = 200,
  url = "https://example.com",
  method = "GET",
  headers = list(),
  body = raw()
)

Arguments

status_code: HTTP status code. Must be a single integer.
url: URL response came from; might not be the same as the URL in the request if there were any redirects.
method: HTTP method used to retrieve the response.
headers: HTTP headers. Can be supplied as a raw or character vector which will be parsed using the standard rules, or a named list.
body: Response, if any, contained in the response body.

Value

An HTTP response: an S3 list with class httr2_response.

Examples

response()
#> <httr2_response>
#> GET https://example.com
#> Status: 200 OK
#> Body: Empty
response(404, method = "POST")
#> <httr2_response>
#> POST https://example.com
#> Status: 404 Not Found
#> Body: Empty
response(headers = c("Content-Type: text/html", "Content-Length: 300"))
#> <httr2_response>
#> GET https://example.com
#> Status: 200 OK
#> Content-Type: text/html
#> Body: Empty