De CSV a JSON: Trabajando con datos tabulares en APIs
Cómo convertir hojas de cálculo en JSON para APIs, qué tener en cuenta con las cabeceras y las comillas, y cómo validar los datos antes de enviarlos.
CSV es el formato con el que el mundo empresarial sigue moviendo datos: exportaciones de CRMs, extractos bancarios e informes de inventario. JSON es lo que esperan la mayoría de las APIs REST y serverless. Convertir entre ambos de forma limpia ahorra horas de scripts improvisados.
La estructura habitual: array de objetos
Para las APIs, la estructura JSON más conveniente es un array de objetos, un objeto por fila, con las claves tomadas de la fila de cabecera:
[
{ "sku": "A-100", "qty": "12", "warehouse": "East" },
{ "sku": "B-220", "qty": "3", "warehouse": "West" }
]
Ten en cuenta que CSV maneja cadenas de texto a menos que añadas un paso de tipado adicional. Tu API debe convertir qty a número si es necesario.
Cabeceras y consistencia
- La primera fila debe contener los nombres de columna; renombra los duplicados antes de la conversión.
- Presta atención a los caracteres BOM al inicio de exportaciones UTF-8 desde Excel: pueden romper un parser básico y convertir tu primera cabecera en
\uFEFFsku. - Los campos entre comillas pueden contener comas y saltos de línea; los parsers bien construidos los gestionan correctamente; dividir por comas con regex, no.
Cuando JSON → CSV
Las herramientas de reportes y los adjuntos de correo suelen necesitar CSV de nuevo. Exporta una fila por objeto; usa la unión de todas las claves como columnas si los objetos difieren (las filas incompletas quedan con celdas vacías).
Valida antes de producción
Tras la conversión, pasa tu JSON por un JSON Formatter para detectar comas finales, comillas simples o valores NaN accidentales provenientes de fórmulas de hoja de cálculo.
Si tu pipeline también acepta YAML desde repositorios de configuración, YAML to JSON puede ayudarte a alinear todo con los mismos tests de esquema JSON.
Pruébalo en local
Nuestro CSV ↔ JSON Converter funciona en el navegador: pega una exportación de ejemplo, obtén el JSON formateado, o hazlo al revés para un informe rápido. Ningún archivo sale de tu dispositivo.
Trata el CSV como entrada no confiable si los usuarios lo suben: limita el tamaño, analiza posibles inyecciones de fórmulas en Excel (
=cmd|), y nunca ejecutes celdas como código.
Resumen
- Prefiere cabecera + filas → array de objetos para las APIs.
- Respeta las reglas de entrecomillado; evita parsers CSV artesanales en producción.
- Siempre valida el JSON y el esquema antes de enviarlo a servicios posteriores.