Formatear JSON

Por qué el JSON sin formato causa problemas reales

Un archivo JSON guardado por una herramienta, editado por un script y luego versionado por una tercera persona tiende a acumular espaciado inconsistente, mezcla de tabulaciones y espacios, y claves en el orden que el último serializador decidió usar. Nada de eso rompe el análisis del archivo, pero arruina la revisión de código: un cambio de una línea puede mostrarse como un diff de cientos de líneas porque una clave cambió de posición o todo el objeto se volvió a indentar. Los equipos que guardan configuración, fixtures o capturas de API como JSON sufren esto constantemente.

Qué hace exactamente el endpoint

Llama a POST /data/json-format con un cuerpo JSON y recibe un task_id de inmediato, ya que el formateo corre como una tarea asíncrona. El servicio analiza el payload, lo vuelve a serializar con una sangría consistente y configurable y, cuando lo solicita, ordena las claves de cada objeto alfabéticamente en todos los niveles de anidamiento, de modo que la salida sea idéntica byte a byte cada vez que entran los mismos datos lógicos. Los arreglos conservan su orden original, porque ahí el orden suele tener significado, y solo las claves de los objetos quedan sujetas al ordenamiento estable.

El orden estable y por qué importa

La especificación de JSON nunca exigió un orden de claves, lo cual es técnicamente correcto pero incómodo en la práctica: dos librerías pueden serializar el mismo objeto exacto con las claves en una secuencia distinta, y un diff de texto ingenuo marcará eso como un cambio aunque nada relevante se haya movido. El orden estable de claves elimina esa ambigüedad por completo, convirtiendo al JSON en un artefacto normalizado y comparable en lugar de una bolsa de propiedades sin orden que luce distinta en cada corrida.

Dónde encaja en una tubería automatizada

Coloque este paso donde el JSON cruce una frontera que finalmente leerá una persona: antes de subir configuración generada a un repositorio, antes de guardar fixtures de respuestas de API para pruebas, o justo antes de escribir un payload en un log o una bitácora de auditoría. Combina bien con el minificador para la necesidad opuesta — formatear para humanos durante el desarrollo y volver a minificar antes de enviar a producción — usando los mismos datos con dos presentaciones distintas.

Entrega, precio y estado

El JSON formateado se entrega por un webhook firmado, recomendado para tuberías automatizadas, o un enlace firmado válido durante 24 horas; el origen y la salida se eliminan tras la ventana de retención y nunca se usan para entrenar modelos. El precio es un fijo de $0.002 por solicitud sin importar el tamaño del payload, y una tarea fallida — por ejemplo, un JSON inválido que no se puede analizar — nunca se cobra tras los tres reintentos estándar. Este endpoint está activo ahora.