% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/rppo.R
\name{rppo}
\alias{rppo}
\title{Query the EPPO API RPPO endpoints.}
\usage{
rppo(
  rppoCodes,
  services = c("overview", "categorization"),
  apiKey = Sys.getenv("EPPO_API_KEY")
)
}
\arguments{
\item{rppoCodes}{\code{character} (vector). One or more RPPO codes to query.
Available RPPO codes can be retrieved via the \code{references/rppos} service.}

\item{services}{\code{character} (vector). One or more RPPO services to query.
Common service names include: \code{overview} and \code{categorization}. A
validation step ensures that all provided services match the supported
service names.

By default: all services.}

\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 for all the specified RPPO
codes.
}
\description{
This function queries the RPPO endpoints of the EPPO Global Database via
REST API for one or more RPPO code(s) and one or more service(s). For each
RPPO code in \code{rppoCodes}, the function sequentially queries all specified
\code{services} and returns the extracted data through a list of dataframes.
}
\examples{
\dontrun{
# Get all information about the European and Mediterranean Plant Protection
# Organisation.
rppoData_ <- rppo(rppoCodes = c("9A"))

# Get categorization data about the European and Mediterranean Plant
# Protection Organisation.
rppoData_ <- rppo(rppoCodes = c("9A"), services = c("categorization"))

# Get basic data about European and Mediterranean Plant Protection
# Organisation and the European Union.
rppoData_ <- rppo(rppoCodes = c("9A", "9L"), services = c("overview"))
}

}
