Guía JSON

JSON vs JSONC

Comparación práctica entre JSON estándar y JSONC, con ejemplos de comentarios, comas finales y situaciones donde una API puede rechazar el contenido.

La diferencia principal

JSON es el formato estándar de intercambio de datos. JSONC significa JSON with Comments y se usa en algunos archivos de configuración para permitir comentarios humanos.

Ejemplo que puede funcionar como JSONC, pero no como JSON

JSONC / configuración con comentario
{
  // Entorno de pruebas
  "apiUrl": "https://api.example.com",
  "reintentos": 3,
}

Versión JSON estricta

JSON válido
{
  "apiUrl": "https://api.example.com",
  "reintentos": 3
}

Por qué importa

Un editor puede aceptar JSONC en archivos de configuración, pero una API, un backend o JSON.parse() pueden rechazarlo. Por eso conviene distinguir el formato del archivo y el parser que lo leerá.

Cuándo usar cada uno

  • Usa JSON estricto para APIs, payloads, respuestas HTTP, integraciones y datos compartidos.
  • Usa JSONC solo cuando la herramienta indique explícitamente que lo soporta.
  • Antes de copiar una configuración a una API, elimina comentarios y comas finales.

Herramientas y errores relacionados

Preguntas frecuentes

¿JSONC es JSON válido?

No necesariamente. JSONC es una variante usada por algunas herramientas para permitir comentarios y, según el parser, comas finales. JSON estándar no los acepta.

¿Puedo enviar JSONC a una API?

No deberías asumirlo. La mayoría de APIs esperan JSON estricto, sin comentarios ni extensiones.

¿Cómo convierto JSONC a JSON?

Quita comentarios y extensiones antes de validarlo como JSON estándar. Después revisa el resultado en el validador.