SHARK4R (version 1.1.0)

get_nua_external_links: Retrieve external links or facts for taxa from Nordic Microalgae

Description

This function retrieves external links related to algae taxa from the Nordic Microalgae API. It takes a vector of slugs (taxon identifiers) and returns a data frame containing the external links associated with each taxon. The data includes the provider, label, external ID, and the URL of the external link.

Usage

get_nua_external_links(slug, verbose = TRUE, unparsed = FALSE)

Value

When unparsed = FALSE: a tibble containing the following columns:

slug

The slug (identifier) of the taxon.

provider

The provider of the external link.

label

The label of the external link.

external_id

The external ID associated with the external link.

external_url

The URL of the external link.

collection

The collection category, which is "External Links" for all rows.

Arguments

slug

A vector of taxon slugs (identifiers) for which to retrieve external links.

verbose

A logical flag indicating whether to display a progress bar. Default is TRUE.

unparsed

Logical. If TRUE, the API response with all facts is returned as an unparsed list. Default is FALSE.

Details

The slugs (taxon identifiers) used in this function can be retrieved using the get_nua_taxa() function, which returns a data frame with a column for taxon slugs, along with other relevant metadata for each taxon.

See Also

https://nordicmicroalgae.org/ for Nordic Microalgae website.

https://nordicmicroalgae.org/api/ for Nordic Microalgae API documentation.

Examples

# \donttest{
  # Retrieve external links for a vector of slugs
  slugs <- c("chaetoceros-debilis", "alexandrium-tamarense")
  try(external_links <- get_nua_external_links(
    slug = slugs, verbose = FALSE
  ))
  if (exists("external_links")) head(external_links)
# }