JSON — Intermedio

Dirigido a desarrolladores con conocimientos básicos de JSON que necesitan dar el salto hacia un uso profesional del formato en entornos reales de integración. A lo largo de las 8 horas del curso, el participante aprenderá a diseñar estructuras JSON para recursos de dominio, a validarlas mediante JSON Schema y a integrarlas en el ciclo completo de una API REST, incluyendo serialización y deserialización desde código. También se trabajará la capacidad crítica de comparar JSON con otros formatos de intercambio de datos, de tomar decisiones justificadas entre estructuras planas y anidadas, y de depurar tanto documentos malformados como fallos de deserialización en tiempo de ejecución. Al finalizar, el participante será capaz de diseñar, adaptar y depurar estructuras JSON de forma autónoma en proyectos de software reales, argumentando sus decisiones técnicas ante el equipo.

1. Comparar JSON con otros formatos de intercambio de datos —como XML o YAML— e identificar las ventajas e inconvenientes de cada uno según el contexto de integración.
2. Diseñar estructuras JSON para recursos de dominio concretos, justificando las decisiones de anidamiento, tipos de datos y nomenclatura de claves.
3. Justificar la elección entre una estructura JSON plana y una anidada argumentando en base a legibilidad, mantenibilidad y consumo por parte del cliente.
4. Diseñar un JSON Schema básico que valide una estructura de dominio, especificando tipos, campos obligatorios y restricciones de formato.
5. Adaptar un esquema JSON existente para incorporar nuevos requisitos sin romper la compatibilidad con consumidores previos.
6. Integrar JSON en el ciclo petición-respuesta de una API REST, serializando datos desde código y operando con los valores deserializados de la respuesta.
7. Depurar documentos JSON malformados o semánticamente incorrectos y fallos de deserialización en código propio, identificando la causa raíz y aplicando la corrección adecuada.

Bloque 1 — JSON en perspectiva: comparativa de formatos Se sitúa JSON dentro del ecosistema de formatos de intercambio de datos analizando sus diferencias estructurales y de uso respecto a XML y YAML. Se estudian escenarios típicos de integración y se evalúan los criterios que determinan la elección de un formato u otro, como la legibilidad humana, el peso del documento, el soporte nativo en distintas plataformas y la verbosidad del esquema.

Bloque 2 — Diseño de estructuras JSON para recursos de dominio Se trabaja el proceso de modelado de un recurso de dominio —usuario, pedido, producto— en JSON, prestando especial atención a las decisiones de anidamiento frente a estructura plana, a la elección de tipos de datos adecuados y a las convenciones de nomenclatura de claves. Se desarrolla un marco de razonamiento para justificar estas decisiones en términos de legibilidad, mantenibilidad y facilidad de consumo por parte del cliente.

Bloque 3 — Validación con JSON Schema Se introduce JSON Schema como herramienta de contrato y validación. El participante aprenderá a especificar tipos de dato, a declarar campos obligatorios y a definir restricciones de formato sobre cadenas, números y arrays. También se aborda la evolución controlada de un esquema para dar cabida a nuevos requisitos —campos opcionales, cambio de tipos, arrays anidados— manteniendo la compatibilidad con consumidores ya existentes.

Bloque 4 — JSON en APIs REST: integración y depuración Se recorre el ciclo completo de una petición-respuesta HTTP con cuerpo JSON, incluyendo la serialización de objetos desde código y la deserialización de la respuesta para operar con sus valores. A continuación se profundiza en la depuración: se identifican patrones de error comunes en documentos malformados o semánticamente incorrectos, y se practica el trazado de fallos de deserialización desde el mensaje de excepción hasta el campo o tipo problemático en el JSON fuente.

• Ordenador con acceso a internet.
• Navegador moderno (Chrome, Firefox, Edge o Safari en versión actualizada).
• Editor de código con soporte para JSON (se recomienda Visual Studio Code con la extensión oficial de JSON).
• Entorno de ejecución del lenguaje de programación empleado en los ejercicios (Node.js ≥ 18, Python ≥ 3.10 u otro acordado con el instructor).
• Cliente HTTP para probar peticiones a APIs REST (Postman, Insomnia o similar).
• Acceso a un validador de JSON Schema en línea (p. ej. jsonschemavalidator.net) o librería equivalente instalada localmente.

Para aprovechar este curso el participante debe haber completado JSON01 — Iniciación o disponer de conocimientos equivalentes: saber leer y escribir documentos JSON válidos, distinguir los tipos de dato primitivos, manejar objetos y arrays anidados, y estar familiarizado con al menos un lenguaje de programación en el que se haya realizado alguna operación de parse o stringify sobre JSON.