Índice de Contenido

Introducción a Flask y las APIs

Si te preguntas ¿cómo crear una API simple con Flask?, has llegado al lugar indicado. Flask es un microframework de Python que facilita la creación de aplicaciones web y APIs RESTful de forma rápida y sencilla. En esta guía fácil para principiantes, aprenderás paso a paso cómo levantar una API básica utilizando Flask, ideal para quienes inician en el mundo del desarrollo backend.

¿Qué es una API y por qué usar Flask?

Una API (Interfaz de Programación de Aplicaciones) permite que diferentes programas se comuniquen entre sí. Con Flask, puedes crear APIs RESTful que reciban solicitudes (requests) y devuelvan respuestas (responses) en formato JSON, facilitando la integración con aplicaciones frontend, móviles o de terceros.

Fácil de aprender: Flask tiene una curva de aprendizaje suave.
Ligero y flexible: Solo usa lo necesario, sin configuraciones complejas.
Documentación clara y gran comunidad.

Requisitos previos

Antes de empezar, asegúrate de tener Python instalado (recomendado 3.7 o superior). También necesitarás un editor de código como VSCode, Sublime Text o PyCharm.

Paso 1: Instalación de Flask

Para comenzar con la creación de una API simple usando Flask, primero instala Flask con el siguiente comando en tu terminal o consola:

pip install flask

Paso 2: Estructura básica del proyecto

Crea una nueva carpeta para tu proyecto y dentro de ella, un archivo llamado app.py. Esta será la base de nuestra API.

mkdir mi_api_flask
cd mi_api_flask
touch app.py

Paso 3: Código inicial para una API básica

Abre app.py y añade el siguiente código para definir tu primera ruta:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route(/)
def home():
    return jsonify({"mensaje": "¡Bienvenido a tu primera API con Flask!"})

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

Explicación del código

Flask se importa y se crea una instancia llamada app.
Se define una ruta principal (/) que retorna un mensaje en formato JSON.
app.run(debug=True) inicia el servidor en modo desarrollo.

Paso 4: Agregar más rutas a la API

Para que tu API REST con Flask sea más útil, puedes agregar más endpoints. Por ejemplo, una ruta que devuelva una lista de usuarios:

@app.route(/usuarios, methods=[GET])
def obtener_usuarios():
    usuarios = [
        {"id": 1, "nombre": "Ana"},
        {"id": 2, "nombre": "Luis"},
        {"id": 3, "nombre": "Sofía"}
    ]
    return jsonify(usuarios)

¿Cómo crear un endpoint POST?

Si deseas agregar datos a tu API, puedes usar el método POST:

from flask import request

@app.route(/usuarios, methods=[POST])
def crear_usuario():
    nuevo_usuario = request.get_json()
    # Aquí normalmente guardarías el usuario en una base de datos
    return jsonify({"mensaje": "Usuario creado", "usuario": nuevo_usuario}), 201

Paso 5: Ejecutar y probar la API

Para ejecutar tu API simple con Flask, corre el siguiente comando:

python app.py

Deberías ver un mensaje como: * Running on http://127.0.0.1:5000/

Abre tu navegador o usa Postman o curl para probar las rutas:

GET http://127.0.0.1:5000/
GET http://127.0.0.1:5000/usuarios
POST http://127.0.0.1:5000/usuarios con un JSON en el cuerpo

Conclusión: ¿Cómo crear una API simple con Flask?

Como has visto, crear una API básica con Flask es un proceso sencillo y rápido. Flask es ideal para quienes se inician en el desarrollo backend, permitiendo crear, probar y escalar APIs de manera eficiente.

Ahora que sabes cómo construir una API REST simple en Flask, puedes experimentar agregando rutas, conectando con bases de datos o implementando autenticación.

¡Sigue practicando y explora más funcionalidades de Flask para llevar tus proyectos al siguiente nivel!