Ejemplo de uso de la API mediante Python

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 DataFrame de Pandas.

Obtener un token de acceso

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

Obtener la URL de descarga de un conjunto de datos

Para obtener la URL desde la cuál descargar los datos más recientes del imae-original, por ejemplo, basta con visitar la página del conjunto de datos en la webapp de Datafaro y mediante el botón de API copiar la URL de la url especificada. Véase la documentación relativa a la página de conjunto de datos para más información.

Descargar los datos

Una vez obtenida la URL de descarga, podemos utilizar la librería requests para descargar los datos en formato CSV. Para ello, basta con realizar una petición GET a la URL de descarga especificando el token de acceso en la cabecera Authorization de la petición.

import requests
import pandas as pd
from io import StringIO
 
url = 'http://datafaro.adatar.do/api/v1/update/?fmt=csv&id=imae-original'
headers = {'Authorization': 'Token YOUR_ACCESS_TOKEN'}
 
response = requests.get(url, headers=headers)
 
if response.status_code == 200:
    # Convierte el contenido de la respuesta a un objeto StringIO y luego úsalo en pd.read_csv
    data = StringIO(response.text)
    df = pd.read_csv(data)
else:
    print("Error en la solicitud:", response.status_code)
 
# Ahora df es un DataFrame de pandas con los datos del CSV