Método GET en FastAPI

¿Cómo implementar métodos HTTP en FastAPI?

Para gestionar nuestras aplicaciones web de manera más eficiente y potenciar nuestras capacidades con FastAPI, es crucial comprender cómo funcionan los métodos HTTP, en particular el método GET. Esta metodología nos permitirá construir aplicaciones más dinámicas e interactivas. A lo largo de esta guía, profundizaremos en el uso de los métodos HTTP, especialmente GET, para gestionar y devolver datos en FastAPI.

¿Cómo retornar diferentes tipos de datos con FastAPI?

FastAPI nos ofrece flexibilidad al retornar diversos tipos de datos desde nuestras funciones. Tradicionalmente, uno podría esperar que una API devuelva strings, pero con FastAPI, podemos devolver:

• Diccionarios: Útiles para estructurar datos complejos.
• Valores booleanos: Para indicar estados verdadero o falso.
• Números: En caso de que necesitemos retornar valores numéricos.
• HTML: FastAPI permite retornar contenido HTML al importar HTMLResponse desde fastapi.responses.

A continuación, veamos un ejemplo de cómo se implementa el HTML:

from fastapi.responses import HTMLResponse

@app.get("/", response_class=HTMLResponse)
def get_html():
    return "<h1>Hello World</h1>"

Este bloque de código muestra cómo retornar HTML de manera sencilla, proporcionando visualización directa de estilos y contenido enriquecido.

¿Cómo crear rutas para gestionar datos?

La creación de rutas específicas en FastAPI es esencial para organizar y estructurar tus aplicaciones web. Para ilustrar cómo gestionar recursos mediante FastAPI, consideremos un ejemplo en el que gestionamos un listado de películas:

1. Inicialización de una lista de películas: Creamos una variable llamada Movies, que contiene una lista de diccionarios con información relevante de cada película, tal como ID, título, descripción, año, calificación y categoría.

2. Definición de la ruta: Utilizaremos el método GET para definir una ruta que nos devuelva el listado de películas.

Movies = [
    {"id": 1, "title": "Inception", "description": "A thriller", "year": 2010, "rating": 8.8, "category": "Action"}
]

@app.get("/movies", tags=["Movies"])
def get_movies():
    return Movies

Al implementar esta ruta, es posible acceder a todo el listado de películas almacenadas en nuestra variable, permitiéndonos extender la funcionalidad según nuestras necesidades.

¿Cómo probar y visualizar los datos retornados?

Probar nuestras rutas y visualizar su salida es un paso esencial para asegurar que nuestro aplicativo funcione como se espera:

• Documentación interactiva: FastAPI genera automáticamente una interfaz Swagger que facilita la visualización y prueba de nuestras rutas.
• Expansión de rutas: Al utilizar la documentación, es posible expandir nuestras rutas y ejecutar las solicitudes directamente desde el navegador.

Próximos pasos con FastAPI

Habiendo abordado el método GET, estamos listos para pasar a métodos HTTP más avanzados como POST, PUT y DELETE. Cada uno de estos métodos nos ofrecerá mayor control sobre la gestión de datos, ampliando aún más las capacidades de nuestras aplicaciones. ¡Sigue aprendiendo y descubre todo lo que puedes lograr con FastAPI!