% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/tools.R
\name{tools}
\alias{tools}
\title{Query the EPPO API Tools endpoints.}
\usage{
tools(
  services = c("name2codes"),
  params = list(name2codes = list()),
  apiKey = Sys.getenv("EPPO_API_KEY")
)
}
\arguments{
\item{services}{\code{character} (vector). One or more Tools services to query.
Common service names include: \code{name2codes}. A validation step ensures that
all provided services match the supported service names.

By default: all services.}

\item{params}{\code{list}. A named list of query parameters to include in the
request. The list of available parameters can be accessed via the
\href{https://data.eppo.int/ui/#/docs/GDAPI}{EPPO API Documentation}
platform.

By default: no parameters, you need to specify the required ones.}

\item{apiKey}{\code{character} (string). The API key used for authentication. It
can be specified manually or through the .Renviron file.

By default: Sys.getenv("EPPO_API_KEY").}
}
\value{
A named list of results, in which each level corresponds to the data
retrieved for each specified service. Each service element contains a
flattened dataframe with the queried content.
}
\description{
This function queries the Tools endpoints of the EPPO Global Database via
REST API. The function sequentially queries all specified \code{services} and
returns the extracted data through a list of dataframes.
}
\examples{
\dontrun{
# Get the EPPO codes associated to the name Bemisia tabaci.
toolsData_ <- tools(params = list(
  name2codes = list(
    onlyPreferred = FALSE,
    name = "Bemisia tabaci")))
}

}
