👉 Crear una API con Python: Introducción a Flask

Hasta ahora hemos aprendido a manejar archivos y bases de datos en Python. Pero, ¿cómo podemos conectar nuestra aplicación con otros sistemas o aplicaciones web? La respuesta es: crear una API (Interfaz de Programación de Aplicaciones).

Hoy aprenderás:
✔️ ¿Qué es una API y por qué es importante?
✔️ Cómo instalar y usar Flask en Python
✔️ Crear una API simple con Flask
✔️ Ejemplo práctico paso a paso

---

1️⃣ ¿Qué es una API y por qué es importante?

Una API (Application Programming Interface) es un conjunto de reglas que permite a dos aplicaciones comunicarse entre sí.

📌 Ejemplos de APIs en la vida real:
✅ Una app de clima obtiene datos del tiempo de una API de meteorología.
✅ Un sitio web de pago usa una API de PayPal para procesar transacciones.
✅ Una aplicación móvil obtiene datos de una base de datos a través de una API.

En Python, podemos crear una API con Flask, un framework ligero y fácil de usar.

---

2️⃣ Instalar Flask en Python

Antes de empezar, instala Flask ejecutando el siguiente comando en tu terminal:

pip install flask

---

3️⃣ Crear una API Simple con Flask

Ahora, vamos a crear un servidor con Flask que devuelva un mensaje cuando accedamos a una ruta específica.

🔹 Código básico de una API en Flask

from flask import Flask

app = Flask(__name__)

@app.route('/')
def inicio():
    return {"mensaje": "¡Hola, bienvenido a mi API en Flask!"}

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

📌 Explicación:
✅ Flask(__name__) → Crea una instancia de Flask.
✅ @app.route('/') → Define una ruta para la API ("/" es la página principal).
✅ return {"mensaje": "Hola"} → Devuelve un JSON con un mensaje.
✅ app.run(debug=True) → Inicia el servidor en modo de desarrollo.

📌 Para probar la API:
1️⃣ Guarda el código en un archivo api.py.
2️⃣ Ejecuta python api.py.
3️⃣ Abre un navegador y visita http://127.0.0.1:5000/.

📌 Salida esperada en el navegador:

{"mensaje": "¡Hola, bienvenido a mi API en Flask!"}

---

4️⃣ Crear una API con Rutas Dinámicas

Podemos mejorar nuestra API permitiendo parámetros en la URL.

from flask import Flask

app = Flask(__name__)

@app.route('/saludo/<nombre>')
def saludo(nombre):
    return {"mensaje": f"Hola, {nombre}! Bienvenido a la API."}

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

📌 Prueba la API en tu navegador visitando:
👉 http://127.0.0.1:5000/saludo/José

📌 Salida esperada:

{"mensaje": "Hola, José! Bienvenido a la API."}

✅ <nombre> permite recibir un valor dinámico desde la URL.

---

5️⃣ Enviar y Recibir Datos con POST en Flask

A veces, necesitamos recibir datos desde una aplicación externa. Para esto, usamos métodos HTTP, como POST.

🔹 Ejemplo: Recibir datos con POST

from flask import Flask, request

app = Flask(__name__)

@app.route('/sumar', methods=['POST'])
def sumar():
    datos = request.get_json()
    resultado = datos['a'] + datos['b']
    return {"resultado": resultado}

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

📌 Cómo probarlo:
Usa Postman o ejecuta este comando en la terminal:

curl -X POST http://127.0.0.1:5000/sumar -H "Content-Type: application/json" -d '{"a": 5, "b": 3}'

📌 Salida esperada:

{"resultado": 8}

✅ request.get_json() → Recibe datos en formato JSON desde una petición POST.
✅ Se suman los valores y se devuelve un JSON con el resultado.

---

6️⃣ Conectar Flask con una Base de Datos SQLite

Podemos conectar nuestra API con una base de datos para almacenar información.

🔹 Ejemplo: API con SQLite para manejar usuarios

from flask import Flask, request, jsonify
import sqlite3

app = Flask(__name__)

# Crear base de datos
conexion = sqlite3.connect("usuarios.db", check_same_thread=False)
cursor = conexion.cursor()
cursor.execute("CREATE TABLE IF NOT EXISTS usuarios (id INTEGER PRIMARY KEY, nombre TEXT)")
conexion.commit()

@app.route('/usuarios', methods=['POST'])
def agregar_usuario():
    datos = request.get_json()
    cursor.execute("INSERT INTO usuarios (nombre) VALUES (?)", (datos['nombre'],))
    conexion.commit()
    return jsonify({"mensaje": "Usuario agregado con éxito"}), 201

@app.route('/usuarios', methods=['GET'])
def obtener_usuarios():
    cursor.execute("SELECT * FROM usuarios")
    usuarios = cursor.fetchall()
    return jsonify({"usuarios": usuarios})

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

📌 Explicación:
✅ Se crea una base de datos SQLite llamada usuarios.db.
✅ POST /usuarios → Permite agregar un usuario.
✅ GET /usuarios → Devuelve la lista de usuarios almacenados.

---

🚀 Conclusión

Hoy aprendimos a crear una API con Flask en Python, desde lo más básico hasta integrar una base de datos.

✅ Flask es un framework ligero para construir APIs en Python.
✅ Podemos definir rutas dinámicas y recibir datos mediante POST.
✅ Podemos conectar nuestra API con una base de datos SQLite.

En el próximo post, veremos cómo desplegar nuestra API en la nube usando servicios como Heroku o Render. ¡No te lo pierdas!

📂 Descarga ejemplos y ejercicios en mi GitHub: github.com/josecodetech

🎥 Aprende con mis videos en YouTube: https://www.youtube.com/@josecodetech

💬 Déjame un comentario si tienes dudas o quieres que cubra algún tema en detalle.