nano cURL - a minimalist http(s) client - async edition.
ncurl_aio(
url,
convert = TRUE,
method = NULL,
headers = NULL,
data = NULL,
response = NULL,
timeout = NULL,
tls = NULL
)An 'ncurlAio' (object of class 'ncurlAio' and 'recvAio') (invisibly). The following elements may be accessed:
$status - integer HTTP repsonse status code (200 - OK).
Use status_code for a translation of the meaning.
$headers - named list of response headers supplied in
'response', or NULL otherwise. If the status code is within the 300
range, i.e. a redirect, the response header 'Location' is automatically
appended to return the redirect address.
$data - the response body, as a character string if
'convert' = TRUE (may be further parsed as html, json, xml etc. as
required), or a raw byte vector if FALSE (use writeBin to
save as a file).
the URL address.
[default TRUE] logical value whether to attempt conversion of the received raw bytes to a character vector. Set to FALSE if downloading non-text data.
(optional) the HTTP method (defaults to 'GET' if not specified).
(optional) a named character vector specifying the HTTP
request headers, for example:
c(Authorization = "Bearer APIKEY", `Content-Type` = "text/plain")
A non-character or non-named vector will be ignored.
(optional) character request data to be submitted.
(optional) a character vector specifying the response headers
to return e.g. c("date", "server"). These are case-insensitive and
will return NULL if not present. A non-character vector will be ignored.
(optional) integer value in milliseconds after which the transaction times out if not yet complete.
(optional) applicable to secure HTTPS sites only, a client TLS
Configuration object created by tls_config. If missing or
NULL, certificates are not validated.
ncurl_session for persistent connections.
nc <- ncurl_aio("https://www.r-project.org/",
response = c("date", "server"),
timeout = 2000L)
call_aio(nc)
nc$status
nc$headers
nc$data
Run the code above in your browser using DataLab