Práctica · Bloque 1
Aprende HTTP construyendo APIs pequeñas
Arranca, modifica y prueba APIs pequeñas para observar HTTP, JSON, OpenAPI, latencia y asincronía.
Starter, código, ejecución y evidencia
La actividad principal ocurre en el editor
Descarga el starter, ejecuta el baseline, modifica la API y conserva una prueba positiva y otra negativa. Las pocas actividades de análisis están marcadas de forma explícita; no cuentan como implementación.
Laboratorios y contraste
Entrena la capacidad concreta
Escoge por la API o el fallo que quieras construir y demostrar; no hay un orden obligatorio.
- Corregir una actualización rechazadaUna aplicación dejó de actualizar expedientes después de que el endpoint adoptara JSON Merge Patch. El ticket incluye el requisito vigente, el comando `curl` usado para reproducir el fallo y la respuesta completa del servidor.Abrir
- El código de estado del incidenteUna API documental responde siempre con `200`, incluso cuando el consumidor no puede continuar. El equipo ya acordó usar `422` para datos JSON bien formados que incumplen el schema y `503` para dependencias temporalmente no disponibles; debes aplicar esa política a seis resultados concretos.Abrir
- Contrato REST de una biblioteca de investigaciónUna biblioteca interna necesita que otros sistemas consulten documentos y autores, y registren préstamos. El encargo describe capacidades, pero no rutas ni operaciones.Abrir
- JSON que parece válidoUn importador rechaza varios payloads por motivos distintos. Algunos ni siquiera son JSON; otros son JSON válido pero contradicen el contrato esperado.Abrir
- Leer una API desde OpenAPIDebes preparar una integración con un catálogo cultural, pero solo dispones de un documento OpenAPI acotado. La interfaz gráfica no está disponible.Abrir
- Seguro, idempotente o ninguna de las dosTras varios timeouts, un cliente reintenta todas sus peticiones por igual. Debes revisar si la semántica declarada por cada operación permite hacerlo.Abrir
- Dónde se consume la latenciaUn `GET /v1/records/REC-204` tarda unos 306 ms. Soporte adjunta los tiempos acumulados de `curl`, el `X-Request-ID` de la respuesta y el log estructurado producido por la misma ejecución.Abrir
- Elegir async desde un perfil realAntes de cambiar tres endpoints a `async def`, el equipo ha medido cuánto tiempo consume cada uno en CPU y cuánto espera a sistemas externos. Solo hay un worker de proceso durante la prueba.Abrir
- Cambio compatible o rupturaUn proveedor propone una versión nueva de su contrato y afirma que ningún consumidor deberá cambiar. Debes revisar el diff antes de aprobarlo.Abrir
Después de los ejercicios focalizados
Prácticas extendidas
Mantienen una base común durante varias transformaciones y permiten trabajar con más continuidad.
- Soporte de una API desconocidaUna aplicación móvil dejó de crear expedientes tras una actualización del proveedor. El mismo ticket, tráfico capturado y documento OpenAPI acotado se conservan durante las tres partes.Abrir
- Contrato de consulta de datos públicosUn equipo de análisis quiere consultar indicadores municipales desde una API interna. Solo existe una pequeña muestra tabular y varias restricciones de consumo.Abrir