Format Atlas

Guías

Elegir formatos de datos y configuración web

Considera JSON para intercambios entre máquinas como API, YAML para configuración editada por personas y XML para integraciones existentes basadas en esquemas.

¿Qué formato deberías elegir?

Elige según la función de cada archivo en tu flujo de trabajo.

  • API web → JSON
  • Ajustes editados a mano → YAML
  • Esquema o contrato existente → XML

Usa el formato exigido por el receptor

Los tres representan datos estructurados, pero difieren en sintaxis, comentarios, tipos y esquemas. Comprueba primero el contrato y las herramientas.

Formatos a considerar

JSON

Adecuado para: API e intercambio basado en JSON

Menos adecuado para: Ajustes manuales que requieren comentarios

YAML

Adecuado para: Configuración mantenida por personas

Menos adecuado para: API que solo aceptan JSON

XML

Adecuado para: Esquemas e integraciones XML existentes

Menos adecuado para: API sencillas nuevas sin requisitos XML

Antes de exportar

  • No supongas que YAML es un superconjunto estricto de JSON.
  • Confirma codificación, tipos y tratamiento de esquemas con el receptor.

Comparaciones relacionadas

JSON vs YAMLJSON es un formato de texto estricto muy usado en API e intercambio de datos entre programas. YAML ofrece una sintaxis adecuada para configuración y datos estructurados editados por personas. Elige según el ecosistema y el flujo.XML vs JSONXML y JSON son formatos de texto para datos estructurados, pero usan estructuras y convenciones distintas.

Guías

Elegir un formato de intercambio de datosEmpieza por las especificaciones del receptor. Usa JSON para datos estructurados de API, XML si la integración exige su esquema y CSV para una sola tabla.

Referencias y especificaciones