Lección 2
YAML vs JSON en español
Elige el formato adecuado para configs y APIs.
YAML y JSON pueden representar el mismo modelo de datos, pero optimizan flujos de trabajo distintos.
Legibilidad
YAML elimina llaves y comillas en casos habituales, lo que hace configs grandes más fáciles de escanear:
database:
host: localhost
port: 5432
El equivalente en JSON es válido pero más ruidoso para editores humanos.
Rigurosidad
JSON es más estricto y más fácil de parsear de forma segura a escala. Por eso muchas APIs usan JSON para entrada no confiable, mientras YAML es habitual en repos de config confiables y mantenidos por humanos.
Comentarios y comas finales
YAML permite comentarios #. El JSON estándar no. Esto importa cuando los equipos documentan flags no obvios directamente en archivos de CI o Helm.
Flujos de conversión
Los equipos suelen:
- Exportar JSON desde una API o generador
- Convertir a YAML para ediciones manuales
- Convertir de vuelta a JSON para herramientas que solo aceptan JSON
La conversión ida y vuelta preserva datos, pero el orden de claves, las comillas y los comentarios pueden cambiar. Revisa siempre los diffs tras la conversión.
Cuándo preferir JSON
- APIs HTTP públicas y payloads orientados al navegador
- Logs y eventos generados por máquina
- Pipelines que deben rechazar tipado ambiguo
Cuándo preferir YAML
- Archivos de Kubernetes y Compose en git
- Definiciones de workflows de CI editadas por desarrolladores
- Config de aplicación con comentarios y cadenas multilínea