viernes 3 enero 2025

Cómo crear APIs web con Falcon

Falcon es un framework minimalista y de alto rendimiento para construir APIs web en Python. Es ideal para desarrollar servicios rápidos y escalables, ofreciendo herramientas para manejar solicitudes HTTP de manera eficiente y segura.

¿Qué es Falcon y para qué sirve?

Falcon permite crear APIs RESTful de manera sencilla gracias a su enfoque en el rendimiento y la simplicidad. Está diseñado para aplicaciones donde la velocidad y la estabilidad son cruciales, como microservicios y backend para aplicaciones móviles o IoT.

Ventajas de usar Falcon:

Rendimiento superior: Procesa solicitudes rápidamente con un bajo consumo de recursos.
Fácil de usar: Su API es sencilla y se enfoca en el manejo de HTTP.
Extensibilidad: Permite personalizar middleware y manejar errores de forma específica.

Ejemplo básico de API con Falcon

import falcon

class HelloWorldResource:
    def on_get(self, req, resp):
        resp.media = {'message': '¡Hola, mundo!'}

app = falcon.App()
app.add_route('/hello', HelloWorldResource())

En este ejemplo:

Creamos un recurso HelloWorldResource con un método on_get que responde a solicitudes GET.
Configuramos una ruta /hello que apunta al recurso.

Para ejecutar la API, puedes usar un servidor WSGI como gunicorn:

gunicorn myapp:app --bind 0.0.0.0:8000

Tabla de métodos en Falcon

Método	Descripción	Ejemplo de uso
`on_get`	Maneja solicitudes GET	Consultar datos
`on_post`	Maneja solicitudes POST	Enviar nuevos datos
`on_put`	Maneja solicitudes PUT	Actualizar datos existentes
`on_delete`	Maneja solicitudes DELETE	Eliminar datos
`on_patch`	Maneja solicitudes PATCH	Modificar parcialmente datos

Algunos ejemplos prácticos

1. API para listar usuarios

class UserResource:
       def on_get(self, req, resp):
           resp.media = [{'id': 1, 'name': 'Juan'}, {'id': 2, 'name': 'Ana'}]
   app.add_route('/users', UserResource())

2. API para crear un recurso

class CreateResource:
       def on_post(self, req, resp):
           data = req.media
           resp.media = {'status': 'Recurso creado', 'data': data}
   app.add_route('/create', CreateResource())

Referencias

Consulta la documentación oficial de Falcon para más detalles y ejemplos avanzados.

Etiquetas:

python falcon

Creado por:

Jorge García

Fullstack developer