Lección 4
CSV a JSON para fixtures de API
Convierte muestras de hoja de cálculo en objetos JSON para mocks, tests y documentación.
El CSV suele ser cómo llegan los datos de muestra. El JSON suele ser cómo los desarrolladores necesitan usarlos.
Para mocks de API, tests y documentación, una fila de encabezado suele mapearse bien a claves de objeto JSON:
id,name,active
1,Ada,true
[
{
"id": 1,
"name": "Ada",
"active": true
}
]
La inferencia de tipos es una elección
Convertir "1" en 1 y "true" en true puede ser útil para fixtures. Pero puede ser peligroso para:
- IDs de cuenta con ceros a la izquierda
- Códigos postales
- Identificadores numéricos grandes
- Códigos que parecen números pero son realmente cadenas
Desactiva la inferencia de tipos cuando el texto exacto importa.
Lista de comprobación para fixtures de API
- Usa nombres de encabezado estables que coincidan con el contrato de la API.
- Mantén recuentos de filas pequeños para tests unitarios.
- Conserva cadenas cuando IDs o códigos necesiten formato exacto.
- Valida el JSON final con un formateador o esquema cuando el payload importe.
Conclusión clave
CSV → JSON no es solo un cambio de formato. Es una decisión de esquema: claves, tipos, nulls y arrays deben coincidir con la API objetivo.
Usa el Conversor CSV con inferencia de tipos activada y desactivada para comparar la salida del fixture.