Este repositorio contiene una API desarrollada en Python usando Flask, requests, y BeautifulSoup4 para recuperar el valor de la Unidad de Fomento (UF) para una fecha específica. La API permite a los usuarios consultar el valor de la UF para cualquier fecha mayor al 01-01-2013.
- Python 3.8+
- Flask
- requests
- beautifulsoup4
- pytest
Para usar la API, clone el repositorio e instale las dependencias. Luego, inicie el servidor Flask ejecutando el siguiente comando:
$ flask run
La API expone un endpoint(/api/date) que acepta solicitudes GET y POST:
Con la fecha como parámetro URL o como parámetro de cuerpo en formato JSON.
El formato del parámetro fecha es DD-MM-YYYY.
Parámetros de consulta:
date
: la fecha para la cual se debe recuperar el valor de la UF. Debe estar en el formatoDD-MM-YYYY
.
Ejemplo:
$ curl http://127.0.0.1:5000/api/date?date=01-02-2015
Cuerpo:
date
: la fecha para la cual se debe recuperar el valor de la UF. Debe estar en el formatoDD-MM-YYYY
.
Ejemplo:
$ curl -X POST -H "Content-Type: application/json" -d '{"date": "01-02-2015"}' http://127.0.0.1:5000/api/date
Ejemplo de respuesta satisfactoria:
{
"UF": 23786.62
}
Si la fecha falta, o si no está en el formato correcto, o si no está dentro del rango permitido, entonces la API devolverá un mensaje de error en formato JSON:
{
"error": "DATE_MISSING",
"message": "Date is a required parameter."
}
{
"error": "DATE_INVALID_FORMAT",
"message": "Date format must be DD-MM-YYYY."
}
{
"error": "DATE_INVALID_RANGE",
"message": "Date must be greater than 01-01-2013 and less than today."
}
Si hay un error de red al intentar recuperar el valor de la UF, entonces la API devolverá un mensaje de error en formato JSON:
{
"error": "CONNECTION_ERROR",
"message": "Unable to retrieve UF value due to a network error."
}
Para ejecutar las pruebas unitarias, instale la biblioteca pytest
y ejecute el siguiente comando:
$ pytest
Las pruebas garantizan que la API devuelva las respuestas esperadas para entradas válidas e inválidas.