Retrieve available references for a given taxon concept.

spp_references(taxon_id, raw = FALSE, token = NULL, verbose = TRUE,
  ...)

Arguments

taxon_id

a vector of character strings containing species' taxon concept identifiers (see spp_taxonconcept()).

raw

a logical. Should raw data be returned?

token

a character string containing the authentification token, see https://api.speciesplus.net/documentation. Default is set to NULL and requires the environment variable SPECIESPLUS_TOKEN to be set directly in Renviron. Alternatively, set_token() can be used to set SPECIESPLUS_TOKEN for the current session.

verbose

a logical. Should extra information be reported on progress?

...

Further named parameters, see httr::GET().

Value

If raw is set to TRUE then an object of class spp_raw (or spp_raw_multi if length(taxon_id)>1) is returned which is essentially a list of lists (see option as = 'parsed' in httr::content()). Otherwise, an object of class spp_refs (or spp_refs_multi if length(taxon_id)>1) is returned which is a list of one data frame:

  • references that includes the identifier of the reference and the corresponding citation.

References

https://api.speciesplus.net/documentation/v1/references/index.html

Examples

# \donttest{ res1 <- spp_references(taxon_id = '4521')
#> → Now processing taxon_id '4521'......................
#> Error in rcites_res(q_url, token, ...): Unauthorized (HTTP 401).
res2 <- spp_references(c('4521', '3210', '10255'))
#> → Now processing taxon_id '4521'......................
#> Error in rcites_res(q_url, token, ...): Unauthorized (HTTP 401).
res3 <- spp_references(taxon_id = '4521', raw = TRUE, verbose = FALSE, config = httr::progress())
#> Error in rcites_res(q_url, token, ...): Unauthorized (HTTP 401).
# }