Qué es una API REST y con qué verbos se le habla
Tus datos están guardados y encerrados al mismo tiempo. Qué es una API, qué significa REST, cómo se escriben la dirección de una colección y la de un elemento, qué es JSON, y los cuatro verbos GET, POST, PUT y DELETE con el código de estado que devuelve cada uno cuando sale bien.
Tu primer endpoint con FastAPI, corriendo en tu compu con uvicorn
Ocho líneas y tu computadora contesta. Cómo instalar FastAPI y uvicorn, qué hace el decorador, cómo se lee el comando de arranque y sus seis líneas, y qué hacer cuando el arranque falla. Incluye el Reto 1.1 (ver tu proyecto contestar desde el navegador) y el Reto 1.2 (parámetro de ruta contra parámetro de query).
Pydantic, el portero que revisa los datos antes de dejarlos pasar
Tu puerta solo entrega; en cuanto empiece a recibir, alguien va a mandarte lo que sea. Cómo escribir tres moldes de Pydantic, dónde se ponen en el endpoint, qué trabajos hacen solos, y cómo leer las cuatro claves del 422 con que el servicio rechaza lo que no cumple.
Documentación automática, el menú que se escribe solo
La página con botones que tu servicio ya trae y que nunca escribiste: cómo abrir /docs, probar cada operación desde ahí, ver de dónde sale en /openapi.json, y por qué lo que ejecutas pasa de verdad. Incluye el Reto 1.3 (los cuatro verbos sobre una sola dirección) y el Reto 1.4 (tu primer molde de Pydantic).
Transferencia · El estacionamiento de la plaza necesita una puerta de datos
PARA ACREDITAR. Nombra las direcciones de un recurso que ves por primera vez, elige el verbo que atiende cada operación y justifica el código de estado que devuelve, en una API de estacionamiento que corre en local y sin esqueleto que rellenar.
Transferencia · Las inscripciones del torneo de robótica se están llenando de basura
PARA ACREDITAR. Define el molde de entrada y el de salida de un recurso que ves por primera vez, decide qué campo es obligatorio y qué dato no puede salir en el listado, y comprueba que lo que no cumple se rechaza solo, sin esqueleto que rellenar.
Sesión 1
Clase en vivo presencial de 3 horas (mar 3-nov). La puerta se abre: tu computadora contesta con ocho líneas, las direcciones y los cuatro verbos sobre una lista en memoria, el portero de Pydantic con su 422, y el Portero de la Oficina.
Avance parcial
Entrega al cierre de la Sesión 1: tu API REST con las cinco operaciones del CRUD todavía en memoria, con los moldes de Pydantic de entrada y de salida puestos, los códigos de estado declarados y todo probado desde /docs.
De la lista en memoria a la base de datos real
Tu servicio guarda y se le olvida todo al apagarlo. Cómo escribir la receta de la sesión con yield y finally, pedirla en el paréntesis del endpoint en vez de crearla, ajustar los moldes a las columnas reales y comprobar la persistencia apagando el servidor. Incluye el Reto 2.1 (cerrar el contrato con datos de mentira), el Reto 2.2 (conectar un solo endpoint y compararlo contra la tabla) y el Reto 2.3 (el CRUD completo contra PostgreSQL).
Diagnóstico · La API que se contradice a sí misma
Práctica del sprint. Diagnostica un servicio que no truena y cuyas respuestas no pueden ser todas ciertas a la vez: observa con precisión, escribe una hipótesis antes de tocar nada, compruébala con una medición contra la tabla y corrige.
Transferencia · La biblioteca del barrio presta libros en una libreta
PARA ACREDITAR. Construye la API de una biblioteca comunitaria contra PostgreSQL, con tus propios modelos y tus propias migraciones, recibiendo la sesión como dependencia y comprobando la persistencia apagando el servidor, sin esqueleto que rellenar.
Sesión 2
Clase en vivo presencial de 3 horas (mar 10-nov). La casa detrás de la puerta: la receta de la sesión, el CRUD completo contra PostgreSQL, el número que pone la base, la prueba de apagar y volver a preguntar y la Mudanza de la Oficina.
Entrega final del sprint
Entregable del Sprint 5: el Sistema de Gestión v7, una API REST con FastAPI conectada a PostgreSQL local, con la sesión como dependencia. Siete criterios de aceptación, el límite conocido que hay que declarar, la rúbrica de evaluación y las tres transferencias obligatorias como compuerta.