Users of fredr must authenticate with the FRED API by use of an
API key. This key should be stored as an environment variable,
FRED_API_KEY.
fredr_get_key() will retrieve the key, if set, or it will return NULL
if the key is unset.
fredr_set_key() will set the key for the current R session. For
persistence across sessions, set the environment variable.
See the Details section for more information.
fredr_has_key() returns TRUE if a key can be found. Otherwise it
returns FALSE.
Usage
fredr_set_key(key)
fredr_get_key()
fredr_has_key()
Arguments
key
A valid FRED API key as a string. Obtain one at the API Keys page. Can also be NULL
to unset the key for the current R session.
Details
The preferred method to set the key is to set the FRED_API_KEY
environment variable in an .Renviron file. The easiest way to do this is
by calling usethis::edit_r_environ(). Don't forget to restart R after
setting the key.
References
See St. Louis Fed Web Services API Keys to obtain an API key.
See Also
Note that by using a FRED API key, you agree to the FRED API Terms of Use.
# NOT RUN {original_key <- fredr_get_key()
# Set a once per session keyfredr_set_key("foo")
# Get itfredr_get_key()
# Reset to original keyfredr_set_key(original_key)
# }