FastAPI 'Hola Mundo'

1 Introducción a FastAPI

FastAPI es un framework web moderno de Python para construir APIs. Se basa en Starlette para la capa web y Pydantic para la validación de datos. Las anotaciones de tipo no son solo decoración: impulsan el análisis de solicitudes, la serialización de respuestas y la documentación automática.

Rápido: Alto rendimiento a la par con Node y Go.
Rápido de codificar: Avanza rápidamente en funciones con un mínimo de código repetitivo.
Menos errores: Valida la entrada y la salida automáticamente.
Basado en estándares: Genera OpenAPI, Swagger UI y ReDoc directamente.

Cuando estés listo, haz clic en “Siguiente” y pondremos una aplicación mínima en funcionamiento localmente.

2 Prerrequisitos: Python y Pip

Confirma que Python 3.7+ y pip están instalados:

python --version
pip --version

Si faltan, instálalos desde python.org.

3 Configurar un Entorno Virtual

Mantén las dependencias ordenadas con un entorno virtual.

python -m venv .venv

Actívalo:

# macOS/Linux
source .venv/bin/activate

# Windows (Command Prompt)
.venv\Scripts\activate

Verás (.venv) cuando esté activo.

4 Instalar FastAPI y Uvicorn

Instala FastAPI y Uvicorn (el servidor ASGI) dentro de tu entorno virtual:

pip install "fastapi[all]" uvicorn[standard]

La opción [all] instala Pydantic v2 y dependencias opcionales estándar. Si prefieres instalaciones livianas, usa pip install fastapi uvicorn.

5 Crear main.py

Crea un archivo llamado main.py y añade un endpoint básico:

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI"}

Eso es todo: una importación, una app, una ruta. Los docstrings y las anotaciones de tipo potenciarán la documentación generada.

6 Ejecutar el Servidor con Uvicorn

Inicia el servidor con recarga en caliente durante el desarrollo:

uvicorn main:app --reload

Abre http://127.0.0.1:8000/ para ver tu respuesta JSON.

7 Explorar Documentación Interactiva

FastAPI sirve Swagger UI y ReDoc automáticamente:

Swagger UI: /docs
ReDoc: /redoc
Esquema OpenAPI: /openapi.json

Puedes probar el endpoint directamente desde la documentación y ver modelos de solicitud/respuesta sin ninguna configuración adicional.

8 Añadir una Ruta con un Parámetro de Ruta

Actualiza main.py con una ruta parametrizada:

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    result = {"item_id": item_id}
    if q:
        result["q"] = q
    return result

Gracias a las anotaciones de tipo, item_id se validará como un entero y se documentará automáticamente.

9 Aceptar un Cuerpo de Solicitud (Pydantic)

Define un modelo y acepta payloads JSON:

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    tags: list[str] = []


@app.post("/items/", response_model=Item)
def create_item(item: Item):
    # Normalmente almacenarías esto; aquí solo lo devolvemos.
    return item


@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    result = {"item_id": item_id}
    if q:
        result["q"] = q
    return result

FastAPI valida el JSON, aplica tipos y documenta el modelo en el esquema generado.

10 Lanzar y Manejar Errores

Usa HTTPException para respuestas de error limpias:

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    tags: list[str] = []


db: dict[int, Item] = {}


@app.post("/items/", response_model=Item)
def create_item(item: Item):
    new_id = len(db) + 1
    db[new_id] = item
    return item


@app.get("/items/{item_id}")
def read_item(item_id: int):
    item = db.get(item_id)
    if not item:
        raise HTTPException(status_code=404, detail="Item not found")
    return {"item_id": item_id, **item.dict()}

Ahora, intentar acceder a un ID inexistente devuelve un JSON 404 limpio: {"detail": "Item not found"}.

11 Próximos Pasos y Despliegue

Fija las dependencias: pip freeze > requirements.txt
Prueba el modo de producción: uvicorn main:app --host 0.0.0.0 --port 8000
Despliega en Render, Fly.io, Railway, o una VM con workers Gunicorn + Uvicorn
Usa @app.exception_handler para centralizar el formato de errores
Asegura endpoints con OAuth2/JWT usando fastapi.security

Ahora tienes una API funcional, validación y documentación en vivo. A partir de aquí, puedes expandir rutas, capas y pruebas sin cambiar de framework.

Progreso del Tutorial