Wikipedia provides a useful list of common http headers: http://en.wikipedia.org/wiki/List_of_HTTP_header_fields.

add_headers(..., .headers = character())

Arguments

...

named header values. To stop an existing header from being set, pass an empty string: "".

.headers

a named character vector

See also

accept() and content_type() for convenience functions for setting accept and content-type headers.

Other config: authenticate, config, set_cookies, timeout, use_proxy, user_agent, verbose

Examples

add_headers(a = 1, b = 2)
#> <request> #> Headers: #> * a: 1 #> * b: 2
add_headers(.headers = c(a = "1", b = "2"))
#> <request> #> Headers: #> * a: 1 #> * b: 2
GET("http://httpbin.org/headers")
#> Response [http://httpbin.org/headers] #> Date: 2018-12-17 20:44 #> Status: 200 #> Content-Type: application/json #> Size: 249 B #> { #> "headers": { #> "Accept": "application/json, text/xml, application/xml, */*", #> "Accept-Encoding": "gzip, deflate", #> "Connection": "close", #> "Host": "httpbin.org", #> "User-Agent": "libcurl/7.43.0 r-curl/3.2 httr/1.4.0.9000" #> } #> }
# Add arbitrary headers GET( "http://httpbin.org/headers", add_headers(version = version$version.string) )
#> Response [http://httpbin.org/headers] #> Date: 2018-12-17 20:44 #> Status: 200 #> Content-Type: application/json #> Size: 297 B #> { #> "headers": { #> "Accept": "application/json, text/xml, application/xml, */*", #> "Accept-Encoding": "gzip, deflate", #> "Connection": "close", #> "Host": "httpbin.org", #> "User-Agent": "libcurl/7.43.0 r-curl/3.2 httr/1.4.0.9000", #> "Version": "R version 3.5.1 (2018-12-12)" #> } #> }
# Override default headers with empty strings GET("http://httpbin.org/headers", add_headers(Accept = ""))
#> Response [http://httpbin.org/headers] #> Date: 2018-12-17 20:44 #> Status: 200 #> Content-Type: application/json #> Size: 182 B #> { #> "headers": { #> "Accept-Encoding": "gzip, deflate", #> "Connection": "close", #> "Host": "httpbin.org", #> "User-Agent": "libcurl/7.43.0 r-curl/3.2 httr/1.4.0.9000" #> } #> }