Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/danielcruca/plataformas-abiertas-2026-2c/llms.txt

Use this file to discover all available pages before exploring further.

Flask es un microframework web para Python ligero y minimalista. A diferencia de frameworks más grandes como Django, Flask te permite construir una API desde cero eligiendo cada componente que necesitás, lo que lo hace ideal para aprender los fundamentos del desarrollo back-end y para construir servicios REST de manera rápida y ordenada.

Prerequisitos

  • Python 3.x instalado en tu sistema.
  • pip disponible en la terminal para instalar paquetes.

Estructura del proyecto

Antes de escribir código, creá la siguiente estructura de carpetas y archivos en tu directorio de trabajo. Respetar esta organización desde el comienzo facilita el escalado del proyecto a medida que se agregan más endpoints y funcionalidades.
MI-CARPETA-DE-API/
├── readme.md
├── data/
└── v1/
    ├── run.py
    └── app/
        ├── __init__.py
        └── controllers/
            └── holamundo.py

Instalación de dependencias

Abrí una terminal y ejecutá los siguientes comandos para instalar Flask y Flask-CORS. Se recomienda hacerlo dentro de un entorno virtual para mantener las dependencias aisladas por proyecto.
pip install flask
pip install flask_cors

Archivos clave

El proyecto se compone de tres archivos principales. run.py es el punto de entrada que arranca el servidor. __init__.py contiene la fábrica de aplicaciones que inicializa Flask y registra los Blueprints. holamundo.py es el controlador donde se definen los endpoints.
from app import create_app

app = create_app()

if __name__ == "__main__":
    app.run(debug=True)

Arrancar la API

1

Abrí la terminal en la carpeta v1

Navegá dentro de la carpeta v1 de tu proyecto, que es donde se encuentra el archivo run.py.
cd v1
2

Ejecutá el servidor

Iniciá la API con el siguiente comando:
python run.py
3

Verificá que la API esté corriendo

Si todo salió bien, verás un mensaje en la terminal indicando que el servidor está escuchando en http://127.0.0.1:5000. La API ya está lista para recibir peticiones.
El parámetro debug=True recarga automáticamente el servidor cuando hacés cambios en el código, sin necesidad de reiniciarlo manualmente.

Probar los endpoints

Una vez que la API está corriendo, podés probar los dos endpoints disponibles desde tu navegador, Postman o cualquier cliente HTTP. Endpoint 1 — Hola Mundo:
GET http://127.0.0.1:5000/holamundo-ejemplo/api/v1/holamundo
Respuesta esperada:
"hola mundo"
Endpoint 2 — Saludo con parámetros:
GET http://127.0.0.1:5000/holamundo-ejemplo/api/v1/saludo?nombre=Jose&apellido=Mujica
Respuesta esperada:
{
  "saludo": "Hola Jose Mujica"
}
Si no se envían los parámetros nombre o apellido, la API responde con un error 400 y el mensaje "Faltan parámetros nombre o apellido".

Build docs developers (and LLMs) love