Los nombres duplicados no son seguros porque el último puede reemplazar a los anteriores; la herramienta los rechaza.
Cómo estructurar un JSON antes de descargarlo
Esta herramienta crea un objeto raíz delimitado por llaves. Cada propiedad combina una clave única con un valor de tipo texto, número, booleano, nulo, objeto o arreglo. Elegir el tipo correcto evita que un número termine entre comillas o que los valores true, false y null se conviertan accidentalmente en texto.
Objetos y arreglos complejos
Para incluir datos anidados, selecciona Objeto o Arreglo y escribe un fragmento JSON válido, por ejemplo {"ciudad":"Quito"} o ["admin","editor"]. El generador analiza ese fragmento antes de incorporarlo y no descarga el archivo si encuentra una estructura inválida.
Qué revisar antes de usarlo en una API
Un JSON puede ser sintácticamente válido y aun así no cumplir el contrato de una API. Confirma nombres obligatorios, tipos, valores permitidos y formato de fechas. La descarga utiliza UTF-8 y la extensión .json; para revisar un documento existente utiliza el formateador y validador JSON.
Ejemplo completo: crear un archivo JSON para una integración
Supongamos que una aplicación necesita registrar un pedido. Puedes crear las propiedades pedido como texto, cantidad como número, pagado como booleano y etiquetas como arreglo. El resultado conserva cada tipo:
Esta diferencia importa: 3 es un número que puede sumarse, mientras "3" es texto; false es un booleano, mientras "false" son cinco caracteres. Seleccionar el tipo antes de generar evita varios errores comunes al construir el archivo manualmente.
Cómo representar información anidada
Si el pedido también necesita una dirección, agrega una propiedad de tipo Objeto con {"ciudad":"Quito","pais":"EC"}. Para una lista de productos, utiliza un Arreglo como [{"sku":"P-1","cantidad":2},{"sku":"P-2","cantidad":1}]. El generador valida la sintaxis del fragmento, pero no puede saber si esas propiedades son las que exige tu sistema.
Lista de comprobación antes de descargar
Comprueba que cada clave sea única y tenga el nombre exacto esperado.
Distingue números, textos, booleanos y valores nulos.
Revisa que objetos y arreglos internos contengan JSON válido.
Genera el documento y léelo completo, no solo la primera propiedad.
Prueba el archivo con datos ficticios antes de enviarlo a una API real.
Errores que el generador evita y límites que debes conocer
La herramienta rechaza claves vacías o repetidas, números no finitos y fragmentos incompatibles con el tipo seleccionado. No crea esquemas JSON, no decide campos obligatorios y no transforma fechas o identificadores. Para comprobar reglas de negocio necesitas la documentación o el esquema de la aplicación receptora.
Caso práctico documentado
Estudio de caso: crear un JSON para registrar un pedido
Situación ficticia: una tienda necesita preparar el cuerpo de una solicitud para registrar un pedido. La integración distingue texto, números, booleanos, arreglos y objetos; enviar todos los valores entre comillas cambiaría su significado.
Objetivo y decisiones tomadas
El objetivo fue construir un objeto raíz con cinco propiedades y comprobar sus tipos después de descargarlo. Elegimos pedido como texto porque es un identificador, cantidad como número para permitir cálculos, pagado como booleano, etiquetas como arreglo y direccion como objeto anidado.
Campo
Tipo elegido
Razón
pedido
Texto
El prefijo forma parte del identificador
cantidad
Número
Debe conservarse como valor calculable
pagado
Booleano
Representa dos estados, no las palabras “true” o “false”
Se agregaron los cinco campos seleccionando explícitamente su tipo.
Se generó el documento con una sangría de dos espacios mediante el mismo flujo de la herramienta.
El archivo descargado se analizó nuevamente como JSON válido.
Se comprobó que cantidad fuera un número, pagado un booleano, etiquetas un arreglo de dos posiciones y direccion un objeto.
Se comparó el archivo con el resultado esperado incluido en esta página.
Resultado y aprendizaje
Las cinco propiedades conservaron el tipo seleccionado. El caso demuestra que la herramienta construye y serializa correctamente esta combinación de valores. También muestra una decisión que debe tomar la persona usuaria: un identificador aparentemente numérico puede necesitar el tipo texto para no perder prefijos o ceros iniciales.
Límites: esta prueba comprueba sintaxis, serialización y tipos; no demuestra que los nombres o valores cumplan el contrato de una API concreta. El caso usa información inventada y sigue la metodología de verificación de Nexo Útil.