REST — Intermedio

Este curso está dirigido a desarrolladores con conocimientos básicos de REST que desean consolidar una comprensión sólida del estilo arquitectónico y aplicarla de forma rigurosa en proyectos reales. A lo largo de las ocho horas de formación, el participante profundizará en los principios que distinguen una API bien diseñada de una que solo usa HTTP superficialmente: aprenderá a diseñar contratos completos para dominios concretos, a justificar la elección de método HTTP en función de idempotencia y seguridad, a versionar una API de forma sostenible y a construir respuestas de error semánticamente coherentes. El curso combina análisis crítico de diseños existentes, integración con APIs de terceros y la incorporación de HATEOAS para enriquecer la navegabilidad de los recursos, de modo que al finalizar el participante será capaz de diseñar, evaluar y mejorar APIs REST listas para entornos de producción.

1. Explicar los principios REST que determinan la calidad de diseño de una API, distinguiendo criterios de idempotencia, seguridad semántica y negociación de estado.
2. Diseñar un contrato de API REST completo para un dominio dado, definiendo recursos, URIs jerárquicas, métodos HTTP justificados y códigos de estado apropiados para cada operación.
3. Diseñar una estrategia de manejo de errores consistente, estableciendo una estructura de respuesta uniforme y seleccionando códigos de estado semánticamente correctos para los escenarios de fallo más frecuentes.
4. Depurar secuencias petición-respuesta con comportamiento inesperado, localizando el origen del problema en cabeceras, cuerpo o código de estado mediante herramientas de inspección.
5. Integrar una API REST de terceros en una aplicación cliente, gestionando correctamente la autenticación mediante API Key o Bearer Token.
6. Adaptar el diseño de una API existente para soportar versionado, aplicando y justificando al menos una estrategia (URI, cabecera o parámetro de consulta).
7. Evaluar de forma comparativa un diseño de API con y sin principios REST, identificando violaciones concretas y argumentando su impacto en la interoperabilidad y el mantenimiento.
8. Incorporar el principio HATEOAS en respuestas REST existentes, añadiendo enlaces de navegación que representen las transiciones de estado disponibles del recurso.

Bloque 1 — Diseño de contratos REST El bloque abre con la construcción sistemática de contratos de API: cómo modelar un dominio en recursos, establecer jerarquías de URI coherentes y asignar el método HTTP correcto a cada operación. Se analiza en detalle la semántica de GET, POST, PUT, PATCH y DELETE desde la perspectiva de la idempotencia y la seguridad, de modo que cada decisión de diseño pueda defenderse con argumentos técnicos precisos. El bloque concluye con ejercicios de diseño guiado sobre dominios reales.

Bloque 2 — Calidad y evaluación del diseño A partir de APIs existentes, se identifican las violaciones más habituales a los principios REST —acoplamiento URI-operación, abuso de verbos HTTP, ausencia de representación uniforme— y se mide su efecto en la interoperabilidad y la evolución del sistema. El análisis comparativo proporciona un marco de evaluación reutilizable que el participante podrá aplicar en revisiones de código y auditorías de diseño.

Bloque 3 — Manejo de errores y depuración Este bloque cubre dos caras del mismo problema: diseñar una estructura de respuesta de error consistente —con códigos de estado semánticamente correctos y cuerpos estandarizados— y, cuando algo falla en tiempo de ejecución, localizar el origen del problema inspeccionando cabeceras, cuerpos y trazas de red con herramientas especializadas. Se trabajan escenarios de fallo reales para que el participante gane criterio tanto en la fase de diseño como en la de operación.

Bloque 4 — Integración, versionado y HATEOAS La última parte del curso aborda los retos que aparecen cuando una API crece y convive con múltiples clientes. Se estudian las estrategias de versionado —por URI, por cabecera y por parámetro— y se justifica cuándo elegir cada una. A continuación se practica la integración con APIs de terceros gestionando autenticación mediante API Key y Bearer Token. El bloque cierra con la incorporación del principio HATEOAS en respuestas existentes, añadiendo los enlaces de transición de estado que convierten a un cliente REST en verdaderamente hipermedia-driven.

• Navegador web moderno (Chrome, Firefox o Edge en versión actual).
• Cliente HTTP de escritorio instalado y operativo: Postman (versión ≥ 10) o Insomnia (versión ≥ 2023).
• Herramientas de desarrollo del navegador habilitadas (pestaña Red/Network).
• Acceso a internet para consumir APIs públicas de práctica durante los ejercicios de integración.
• Editor de código con soporte JSON/YAML (Visual Studio Code recomendado) para la redacción de contratos y ejemplos de respuesta.

El participante debe haber completado el curso RES01 — REST Iniciación o demostrar un dominio equivalente de los conceptos fundamentales: arquitectura cliente-servidor, protocolo HTTP (métodos, cabeceras y códigos de estado básicos), formato JSON y realización de peticiones sencillas desde un cliente HTTP.