Escribimos una API simple en Python usando Flask

Imagina que quieres crear tu primera aplicación web o hacer una interfaz de programación (API) que pueda aceptar solicitudes y devolver respuestas. ¿Suena complicado? De hecho, con la ayuda de Flask, un marco web simple pero potente para Python, es muy fácil de hacer. Hoy les mostraré cómo escribir rápidamente una API simple que pueda aceptar solicitudes y responderlas.

¿Qué es Flask?

Flask es un marco web ligero para Python que facilita la creación de aplicaciones web y API. Es fácil de usar y aprender, y también es ideal para pequeños proyectos o para la creación rápida de prototipos de ideas. Flask es una excelente opción para aquellos que quieren entender rápidamente cómo funciona el desarrollo web y cómo escribir una API.

Empezamos: Instalación de Flask

Antes de empezar a escribir el código, tenemos que instalar Flask. Para ello, abre la terminal y ejecuta el siguiente comando:

pip install Flask

Después de eso, tendrás Flask instalado y podrás comenzar a escribir nuestra primera API.

Creación de la primera API de Flask

Ahora crearemos un archivo llamado app.py. En este archivo, escribiremos el código de nuestra API. Abre el editor de código y pega el siguiente código:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/')
def home():
    return "Welcome to our simple API!"

@app.route('/api/greet', methods=['GET'])
def greet():
    response = {
        "message": "Hello! This is a response from our API."
    }
    return jsonify(response)

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

Veamos qué está pasando aquí:

• Importamos Flask y json: Flask nos permite crear una aplicación web, y jsonify se utiliza para devolver datos en formato JSON.

• Crear una instancia de Flask: app = Flask(__name__) — esto crea nuestra aplicación.

• Rutas (@app.route()): Una ruta es una forma de vincular una URL a una función. Por ejemplo, @app.route('/') vincula la página raíz con la función home, que devuelve un mensaje de bienvenida.

• Función greet(): Procesa la solicitud en /api/greet y devuelve una respuesta JSON.

Ejecutar la API

Para ejecutar nuestra API, vuelve a la terminal y ejecuta el siguiente comando:

python app.py

Después de eso, Flask iniciará el servidor y verás un mensaje como:

 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Ahora puedes abrir el navegador e ir a http://127.0.0.1:5000/ para ver el mensaje "¡Bienvenido a nuestra API simple!". Y si vas a http://127.0.0.1:5000/api/greet, verás un JSON con un saludo.

Añadimos nuevas funciones

Crear una API en Flask es como jugar a un juego de construcción: puedes añadir nuevas rutas y funciones para que la API pueda hacer más. Añadamos una ruta que acepte el nombre del usuario y le dé la bienvenida:

from flask import request

@app.route('/api/greet/<name>', methods=['GET'])
def greet_user(name):
    response = {
        "message": f"Hi {name}! This is a personal greeting from our API."
    }
    return jsonify(response)

Ahora, si abres http:// 127.0.0.1:5000/api/greet/Vasya, la API te devolverá un saludo personalizado "¡Hola, Vasya!"

Por qué Flask es simple y potente

Flask es bueno porque con su ayuda puedes crear rápidamente prototipos y aprender desarrollo web sin perder mucho tiempo aprendiendo marcos complejos. Es ligero, fácil de entender y, al mismo tiempo, lo suficientemente potente como para hacer frente a la mayoría de las tareas.

A diferencia de otros marcos, como Django, Flask no requiere muchos ajustes ni archivos adicionales. Te da flexibilidad y control sobre el proyecto, lo que es especialmente importante si estás empezando tu viaje en la programación.

Conclusión

Ahora ya sabes cómo crear una API sencilla en Python con Flask. Esta es una excelente manera de comenzar tu viaje en el mundo del desarrollo web y comprender cómo funcionan los servidores y las solicitudes de los clientes. Flask te ayudará a crear tu primer proyecto de forma rápida y sencilla, y luego podrás hacerlo más complejo, añadir nuevas funciones y aprender en la práctica.