ncurl: ncurl

In nanonext: NNG (Nanomsg Next Gen) Lightweight Messaging Library

ncurl

Description

nano cURL - a minimalist http(s) client.

Usage

ncurl(
  url,
  convert = TRUE,
  follow = FALSE,
  method = NULL,
  headers = NULL,
  data = NULL,
  response = NULL,
  timeout = NULL,
  tls = NULL
)

Arguments

url	the URL address.
convert	[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.
follow	[default FALSE] logical value whether to automatically follow redirects (not applicable for async requests). If FALSE, the redirect address is returned as response header 'Location'.
method	(optional) the HTTP method as a character string. Defaults to 'GET' if not specified, and could also be 'POST', 'PUT' etc.
headers	(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.
data	(optional) character string request data to be submitted. If a vector, only the first element is taken, and non-character objects are ignored.
response	(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.
timeout	(optional) integer value in milliseconds after which the transaction times out if not yet complete.
tls	(optional) applicable to secure HTTPS sites only, a client TLS Configuration object created by tls_config(). If missing or NULL, certificates are not validated.

Value

Named list of 3 elements:

• ⁠$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).

See Also

ncurl_aio() for asynchronous http requests; ncurl_session() for persistent connections.

Examples

ncurl("https://postman-echo.com/get",
       convert = FALSE,
       response = c("date", "content-type"),
       timeout = 1200L)
ncurl("https://postman-echo.com/put",
      method = "PUT",
      headers = c(Authorization = "Bearer APIKEY"),
      data = "hello world",
      timeout = 1500L)
ncurl("https://postman-echo.com/post",
      method = "POST",
      headers = c(`Content-Type` = "application/json"),
      data = '{"key":"value"}',
      timeout = 1500L)

nanonext documentation built on April 4, 2025, 5:18 a.m.