How to set up and use an API key?

Using Sys.setenv() during an interactive session

One way to set up your API key without using the key argument is to use environment variables. Environment variables are system or user-defined variables that are used to store information during your R session.

rromeo searches the environment variable SHERPAROMEO_KEY to check if an API key has been defined. You can access it using the function Sys.getenv() with the name of the variable as as a string:

Sys.getenv("SHERPAROMEO_KEY")

If none has been defined it should return "". You can then set the environment variable using the function Sys.setenv():

Sys.setenv(SHERPAROMEO_KEY = "Iq83AIL5bss")
Sys.getenv("SHERPAROMEO_KEY")
#> [1] "Iq83AIL5bss"

It is set up for the rest of your R session and rromeo will automatically use it when you call the different functions. You can also use the check_key() function that should give the same result if your key is well set-up:

library("rromeo")
check_key()
#> [1] "Iq83AIL5bss"

Using the dedicated function rr_auth()

rromeo provides the function rr_auth() that creates a well named environmental variable that can be used in the rest of your session:

rr_auth("Iq83AIL5bs2")
check_key()
#> [1] "Iq83AIL5bs2"

This works so that you don’t have to specify the name of the environmental variable by hand. Under the hood rr_auth() uses the same mechanism as explained in the above mentioned section.

Setting up your API key in an .Rprofile file

Every time R starts it looks for .Rprofile files in different locations:

• R_HOME the directory in which R is installed,
• HOME the user’s home directory,
• R’s current working directory.

R only loads one .Rprofile file per session and thus an .Rprofile file at the project-level overrides files in other locations.

The .Rprofile file is an R script that is launch each time R starts. Put it at the root of your project and type the following:

SHERPAROMEO_KEY = "Iq83AIL5bss"

You can then reload your session and check that rromeo managed to get your key by using the check_key() function:

check_key()
#> [1] "Iq83AIL5bs2"

Now rromeo can use your SHERPA/RoMEO API key! See the getting started vignette for usage of rromeo functions.

Setting up your API key in an .Renviron file

.Renviron file follow the same loading rules as .Rprofile files, the only difference is that it is is a file whose only purpose is to store environment variables. To use your API key in an .Renviron you have to type the following (note the absence of quotes):

SHERPAROMEO_KEY=Iq83AIL5bss

You can then check that your key has been found using check_key():

check_key()
#> [1] "Iq83AIL5bs2"

Now rromeo can use your SHERPA/RoMEO API key! See the getting started vignette for usage of rromeo functions.

Using the key function argument (NOT RECOMMENDED)

NOTE: This method is NOT RECOMMENDED but still available for testing and development purposes.

All the functions in rromeo that can use an API key have a key argument. To use your API key you have to provide it as a string in the key argument of the functions for example:

rr_journal_issn("1947-6264", key = "YOUR_API_KEY")

However, we do not recommend this approach as your API key will be available in your R history and in your R scripts. While your API key should stay secret as it grants unlimited access to the server and can be maliciously used in wrong hands.

Furthermore using this method you have to specify it at each function call while the other methods shown above only needs to be set up once.