% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/live_data.R
\name{oystermapR_live_config}
\alias{oystermapR_live_config}
\title{Configure live data API credentials for oystermapR}
\usage{
oystermapR_live_config(
  cmems_user = NULL,
  cmems_password = NULL,
  ices_key = NULL,
  show_config = FALSE
)
}
\arguments{
\item{cmems_user}{Character. CMEMS username.}

\item{cmems_password}{Character. CMEMS password.}

\item{ices_key}{Character. ICES API key (currently optional; ICES APIs are
largely open).}

\item{show_config}{Logical. Print current configuration (credentials masked).
Default FALSE.}
}
\value{
Invisibly returns a named list of the options set.
}
\description{
Stores API credentials in R session options so live data fetching can
authenticate with external services. Credentials are \strong{not} written to
disk and are lost when the R session ends.

All parameters are optional - only set credentials for the services you
intend to use. Functions that require a missing credential will warn
and fall back to manual data rather than aborting.
}
\section{Free registrations}{

\itemize{
\item \strong{CMEMS}: Register at \href{https://marine.copernicus.eu}{marine.copernicus.eu}
\item \strong{ICES}: API access is open (no key required for HAB/VMS endpoints)
\item \strong{EMODnet Biology}: Open WFS, no key required
\item \strong{FSA/DAERA}: Open REST API, no key required
}
}

\examples{
\dontrun{
oystermapR_live_config(
  cmems_user     = "myusername",
  cmems_password = "mypassword"
)
# Then use fetch_live = TRUE in any supporting function
score_hab_risk(result, species = "ostrea_edulis", fetch_live = TRUE)
}
}
