Una API con Python y FastAPI

Una API de Python usa TeselaDB con PyMongo, el driver oficial de MongoDB. Aquí escribes con FastAPI la misma API de pedidos que en la guía de Express, que crea un pedido y lo lee.

Lo que vas a construir

Un servidor FastAPI en el puerto 8000 con POST /orders, que valida el pedido con Pydantic y lo guarda, y GET /orders/{order_id}, que lo devuelve o responde 404.

Requisitos

• Python 3.9 o posterior.
• Un clúster de TeselaDB y un usuario con readWrite sobre la base shop.
• La cadena de conexión con TLS en la variable de entorno TESELADB_URI, como en Python.

1. Crea el entorno

python3 -m venv .venv
. .venv/bin/activate
pip install fastapi uvicorn pymongo

2. Escribe la API

Guárdala como main.py. Las funciones de los endpoints son síncronas, así que FastAPI las ejecuta en su grupo de hilos y el cliente de PyMongo comparte sus conexiones entre ellas:

import os
from datetime import datetime, timezone

from bson import ObjectId
from bson.errors import InvalidId
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel, Field
from pymongo import MongoClient

client = MongoClient(os.environ["TESELADB_URI"])
orders = client.shop.orders
app = FastAPI()


class NewOrder(BaseModel):
    customer: str
    total: float = Field(ge=0)


@app.post("/orders", status_code=201)
def create_order(order: NewOrder):
    result = orders.insert_one({**order.model_dump(), "createdAt": datetime.now(timezone.utc)})
    return {"id": str(result.inserted_id)}


@app.get("/orders/{order_id}")
def read_order(order_id: str):
    try:
        order = orders.find_one({"_id": ObjectId(order_id)})
    except InvalidId:
        order = None
    if order is None:
        raise HTTPException(status_code=404)
    order["_id"] = str(order["_id"])
    return order

Probarlo

Arranca el servidor con uvicorn main:app. Después, en otra terminal, crea un pedido de Ana con un total de 30 y léelo con el id que devuelve la primera petición, que sustituye a <id> en la segunda orden:

curl -s -X POST localhost:8000/orders -H "content-type: application/json" -d '{"customer":"Ana","total":30}'
curl -s localhost:8000/orders/<id>

La primera orden devuelve {"id":"…"} y la segunda, el pedido con su fecha de creación. Un pedido con un total negativo responde 422 con el error de validación.

Limpiar

Para el servidor con Ctrl+C y borra los pedidos de prueba desde mongosh:

db.getSiblingDB("shop").orders.deleteMany({ customer: "Ana" });

Siguientes pasos

• Una API con Node.js y Express, la misma API en JavaScript.
• Consultar documentos, con los filtros que puedes pasar a find.