Aprende a crear una API REST con Python usando FastAPI desde cero

En este tutorial, te enseñaremos cómo crear una API REST utilizando FastAPI en Python. FastAPI es un framework web moderno y de alto rendimiento que facilita la creación de APIs rápidas y seguras. Además, cuenta con una sintaxis sencilla y declarativa que permite desarrollar APIs de forma muy eficiente.

¿Qué es una API REST?

Una API REST (Representational State Transfer) es un conjunto de reglas y convenciones para el intercambio de datos entre aplicaciones. Permite a las aplicaciones comunicarse entre sí de manera eficiente y flexible, utilizando los métodos HTTP para realizar operaciones sobre recursos.

¿Qué es FastAPI?

FastAPI es un framework web Python de alto rendimiento que permite crear APIs RESTful de forma rápida y sencilla. Está diseñado para ser fácil de usar, seguro y rápido, utilizando la tipificación estática de Python para mejorar el rendimiento y la seguridad de la aplicación.

Paso 1: Instalación de FastAPI

Lo primero que debemos hacer es instalar FastAPI y uvicorn, un servidor web ASGI de alta velocidad que soporta HTTP/1 y HTTP/2.

pip install fastapi uvicorn

Paso 2: Creación de una aplicación FastAPI

Vamos a crear una aplicación FastAPI básica que exponga un endpoint para consultar información sobre usuarios. Crea un archivo llamado main.py y añade el siguiente código:

from fastapi import FastAPI

app = FastAPI()

@app.get("/users/{user_id}")
def read_user(user_id: int):
    return {"user_id": user_id}

Este código define una nueva aplicación FastAPI con un único endpoint /users/{user_id} que devuelve un objeto JSON con el identificador del usuario. Para ejecutar la aplicación, utiliza el siguiente comando:

uvicorn main:app --reload

Paso 3: Acceder a la API

Abre tu navegador o una herramienta como Postman y accede a la URL http://localhost:8000/users/1. Verás que la API responde con un objeto JSON que contiene el identificador del usuario solicitado.

Paso 4: Añadir más funcionalidades

Ahora vamos a añadir más funcionalidades a nuestra API. Modifica el código de main.py para incluir un nuevo endpoint /items que devuelve una lista de productos:

from fastapi import FastAPI

app = FastAPI()

items = [
    {"id": 1, "name": "Pencil"},
    {"id": 2, "name": "Notebook"}
]

@app.get("/users/{user_id}")
def read_user(user_id: int):
    return {"user_id": user_id}

@app.get("/items")
def read_items():
    return items

Paso 5: Prueba la nueva funcionalidad

Reinicia el servidor utilizando el comando uvicorn main:app –reload y accede a la nueva URL http://localhost:8000/items. Verás que la API devuelve una lista de productos en formato JSON.

¡Felicidades! Has creado tu primera API REST con FastAPI en Python. Ahora puedes explorar más funcionalidades y características avanzadas de FastAPI para desarrollar APIs más complejas y potentes. ¡Buena suerte!