Ejemplo de uso de la API mediante el paquete R datafaro

A continuación se muestra un ejemplo de uso de la API de Datafaro para obtener los datos de un conjunto de datos en formato CSV y cargarlos en un data.frame de R.

Obtener un token de acceso (una única vez)

Para obtener más información sobre el proceso de autenticación, consulte la sección Autenticación.

Instalar el paquete datafaro (una única vez)

Puede instalar el paquete datafaro desde el repositorio de r-universe de Adatar:

install.packages("datafaro", repos = "https://adatar-do.r-universe.dev")

Configurar el token de acceso (una única vez)

Para una guía detallada sobre cómo configurar tu token de acceso con el paquete datafaro, consulta nuestra viñeta "Configuración del Token de Acceso en datafaro". En esta viñeta, cubrimos diferentes métodos para asegurar y acceder a tu token, incluyendo el uso del archivo .Renviron, el paquete keyring, y el paso del token directamente como argumento de función. Estos métodos te ayudarán a mantener tus credenciales seguras mientras aprovechas las funciones avanzadas de datafaro.

Puedes encontrar esta viñeta en la documentación de nuestro paquete en https://datafaro.github.io/datafaroR/articles/tokens.html (opens in a new tab)

O acceder a ella directamente desde R utilizando el siguiente comando:

vignette("tokens", package = "datafaroR")

Descargar los datos

Para descargar los datos utilizando el paquete datafaro, basta con utilizar la función get_data:

library(datafaro)
 
# Obtener los datos de un conjunto de datos
datos <- get_data('imae-original')
 
 
# De forma predeterminada, el token se toma de la variable de entorno DATAFARO_TOKEN. 
# Caso contrario, se puede especificar el token como argumento de la función get_data.
 
# Obtener los datos de un conjunto de datos especificando el token
datos <- get_data('imae-original', .token = '***********************************1bb7f')

Ahora datos es un data.frame de R con los datos del conjunto de datos imae-original. Por defecto, la función get_data devuelve los metadatos del conjunto de datos como un atributo del data.frame con el nombre metadata. Para acceder a los metadatos, basta con utilizar la función attr:

# Obtener los metadatos del conjunto de datos
metadata <- attr(datos, 'metadata')