Web Services: lado servidor (Flask)
Crea tu propia API en Python con Flask: define rutas con @app.route, distingue métodos con request.method, recibe datos por endpoints dinámicos, query string y body, y controla las respuestas y errores con abort y Response.
architecture
El rol del servidor
Ya vimos el lado del cliente (que consume con requests). Ahora nos ponemos del otro lado: el servidor, encargado de disponer el contenido para que pueda ser consultado, y de la lógica que decide qué responder a cada solicitud.
Un servidor puede escribirse en cualquier lenguaje. La interfaz estándar que conecta un servidor web con una aplicación Python se llama WSGI (Web Server Gateway Interface). Se puede programar directamente sobre WSGI, pero es verboso: hay que manejar a mano las rutas, los métodos y la construcción de cada respuesta.
Por eso usaremos un framework que abstrae todo ese trabajo: Flask.
La misión del servidor es exponer recursos y responder solicitudes. El cliente inicia con una request; el servidor ejecuta lógica y devuelve una response.
Nota
Cargando Quiz...
code
Flask: la app y las rutas
Flask es una librería de Python para levantar APIs. Se instala con python3 -m pip install flask. La estructura mínima es: crear la app, asociar funciones a rutas con el decorador @app.route, y devolver la respuesta.
python
from flask import Flask app = Flask(__name__) @app.route('/', methods=['GET'])def hello_world(): return {'texto': 'Hello, World!'} if __name__ == '__main__': app.run(port=4444)Puntos clave:
Flask(__name__)crea la aplicación.@app.route('/ruta', methods=[...])asocia una función a un endpoint y a los métodos HTTP que acepta.- Si la función retorna un
dict, Flask lo convierte automáticamente a una respuesta JSON.
Devolver un diccionario desde una vista de Flask es la forma más simple de responder JSON: Flask se encarga de serializarlo y poner el Content-Type correcto.
Tip
Cargando Quiz...
Cargando Quiz...
tune
Distinguir métodos con request.method
Un mismo endpoint puede aceptar varios métodos y comportarse distinto según cuál se use. Para saber con qué método llegó la petición, usamos el objeto request de Flask y su atributo request.method.
python
from flask import Flask, requestimport random app = Flask(__name__) @app.route('/numero_aleatorio', methods=['GET', 'POST'])def numero_aleatorio(): if request.method == 'POST': return {'numero': random.randint(0, 6), 'metodo': 'POST'} return {'numero': random.randint(-4444, -11), 'metodo': 'GET'}schema
Endpoints dinámicos y argumentos
Flask permite construir endpoints flexibles que reciben datos del cliente de tres formas.
Endpoint dinámico (parte de la ruta)
Una porción de la URL puede ser variable. Se declara con < tipo:nombre > y llega como argumento a la función:
python
@app.route('/hi/<string:username>', methods=['GET'])def saludar(username): return {'texto': f'Hola {username}!'} # /hi/Luna, /hi/Cachirulo, /hi/Guillermo hacen match con esta rutaArgumentos en la query string
Los parámetros tras ? se leen con request.args.get, que permite valor por defecto y tipo:
warning
Respuestas y errores personalizados
A veces no basta con retornar un dict: queremos controlar el código de estado, el tipo de contenido, o señalar un error. Flask ofrece abort y la clase Response para eso.
python
import jsonfrom flask import Flask, Response, abort app = Flask(__name__) @app.route('/error/<int:instruccion>', methods=['DELETE'])def error(instruccion): if instruccion == 0: abort(400) # corta con un 400 Bad Request if instruccion == 1: return Response(status=418) # I'm a teapot