Flask API REST

Flask es un microframework web de Python que se ha consolidado como una de las opciones más populares para el desarrollo de APIs REST debido a su simplicidad, flexibilidad y capacidad de escalamiento. A diferencia de frameworks más pesados, Flask adopta una filosofía minimalista que permite a los desarrolladores construir aplicaciones web y APIs con el control total sobre los componentes que desean utilizar.

¿Qué es una API REST?

Una API REST (Representational State Transfer) es un estilo arquitectónico para diseñar servicios web que utiliza los métodos HTTP estándar para realizar operaciones sobre recursos. Las APIs REST se basan en principios fundamentales como la comunicación sin estado, el uso de URLs descriptivas para identificar recursos, y la manipulación de estos recursos mediante los métodos HTTP apropiados.

En el contexto moderno del desarrollo web, las APIs REST sirven como la columna vertebral de aplicaciones distribuidas, permitiendo que diferentes sistemas se comuniquen de manera eficiente y escalable. Flask proporciona las herramientas necesarias para implementar estos servicios de forma elegante y mantenible.

Fundamentos de Flask para APIs

Flask se distingue por su arquitectura modular que permite añadir funcionalidades según las necesidades específicas del proyecto. Para el desarrollo de APIs REST, Flask ofrece un conjunto de características esenciales que facilitan la creación de endpoints fiables y bien estructurados.

La gestión de rutas en Flask utiliza decoradores Python que mapean URLs específicas a funciones, permitiendo definir endpoints de manera intuitiva. Esta aproximación hace que el código sea legible y mantenible, características fundamentales en el desarrollo de APIs profesionales.

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api/usuarios', methods=['GET'])
def obtener_usuarios():
    usuarios = [
        {'id': 1, 'nombre': 'Ana García'},
        {'id': 2, 'nombre': 'Carlos López'}
    ]
    return jsonify(usuarios)

Métodos HTTP y Operaciones CRUD

Las operaciones CRUD (Create, Read, Update, Delete) se mapean naturalmente con los métodos HTTP en una API REST. Flask facilita la implementación de estos métodos mediante el parámetro methods en el decorador de rutas.

El método GET se utiliza para recuperar información, siendo idempotente y seguro. Los métodos POST permiten crear nuevos recursos, mientras que PUT y PATCH se emplean para actualizaciones completas y parciales respectivamente. El método DELETE elimina recursos específicos del sistema.

@app.route('/api/productos', methods=['POST'])
def crear_producto():
    datos = request.get_json()
    # Lógica de creación
    return jsonify({'mensaje': 'Producto creado exitosamente'}), 201

@app.route('/api/productos/<int:producto_id>', methods=['DELETE'])
def eliminar_producto(producto_id):
    # Lógica de eliminación
    return '', 204

Manejo de Parámetros y Datos de Entrada

Flask proporciona múltiples mecanismos para capturar y procesar datos de entrada. Los parámetros de ruta se definen directamente en la URL utilizando sintaxis de marcadores de posición, mientras que los query strings se acceden mediante el objeto request.args.

Las cabeceras HTTP contienen metadatos importantes sobre la petición, incluyendo información de autenticación, tipo de contenido y preferencias del cliente. Flask permite acceder a estas cabeceras de forma sencilla para implementar lógica condicional basada en los metadatos de la petición.

@app.route('/api/productos/<int:categoria_id>')
def productos_por_categoria(categoria_id):
    limite = request.args.get('limite', 10, type=int)
    orden = request.args.get('orden', 'nombre')
    
    # Lógica de filtrado y ordenamiento
    return jsonify(productos_filtrados)

Gestión de Errores y Códigos de Estado

El manejo de errores consistente es fundamental en APIs profesionales. Flask permite implementar manejadores de errores personalizados que devuelven respuestas JSON estructuradas con códigos de estado HTTP apropiados.

Los códigos de estado HTTP comunican el resultado de cada operación de manera estándar. Los códigos 2xx indican éxito, los 4xx errores del cliente, y los 5xx errores del servidor. Una API bien diseñada utiliza estos códigos de forma consistente para facilitar la integración y depuración.

@app.errorhandler(404)
def recurso_no_encontrado(error):
    return jsonify({
        'error': 'Recurso no encontrado',
        'codigo': 404
    }), 404

@app.errorhandler(ValidationError)
def error_validacion(error):
    return jsonify({
        'error': 'Datos de entrada inválidos',
        'detalles': str(error)
    }), 400