JSON a Kotlin
Convertir JSON a data classes de Kotlin para desarrollo Android y Kotlin
Entrada JSON
Salida Kotlin
¿Qué es JSON a Kotlin?
Cuando estás construyendo una app Android o un servicio backend en Kotlin y recibes una respuesta JSON de la API, necesitas clases de datos Kotlin que coincidan con la estructura antes de poder deserializar nada. Escribirlas a mano — especialmente con objetos profundamente anidados — es lento y fácil de equivocar. Esta herramienta genera clases de datos Kotlin automáticamente desde tu JSON. Pega una respuesta de ejemplo y en segundos tendrás modelos listos para usar con kotlinx.serialization o Gson.
La conversión se ejecuta en tu navegador. Configura el nombre de la data class y el package en la configuración. Activa Data Class para sintaxis data class y Tipos nullable para campos opcionales. No se envía nada a ningún servidor.
Cómo usar esta herramienta
Pegar o subir JSON
Pega tu JSON en el editor izquierdo o sube un archivo. Usa Ejemplo para datos de ejemplo. Configura el nombre de la data class raíz y el package en la configuración. Activa Data Class y Tipos nullable según sea necesario.
Revisar los tipos generados
El panel derecho muestra data classes de Kotlin. Los objetos anidados se convierten en tipos anidados. Los arrays se convierten en List<T>. Usa @SerializedName o @Json si las claves JSON difieren de los nombres de propiedad. Para JSON inválido, usa primero el Formateador JSON o Validador JSON.
Copiar o descargar
Usa Copiar o Descargar. Pégalo en tu proyecto Android o Kotlin. Para formatear JSON primero, usa el Formateador JSON. Para validación, usa el Validador JSON.
Ejemplos de JSON a Kotlin
Aquí un ejemplo de generación de data classes de Kotlin desde un objeto JSON.
Ejemplo: Registro de suscriptor
Entrada JSON:
Salida Kotlin generada:
Cuándo ayuda JSON a Kotlin
Al desarrollar apps Android o servicios backend Kotlin que consuman APIs REST, necesitas data classes tipadas. Pegar una respuesta de ejemplo aquí te da modelos Kotlin para Retrofit, Gson o kotlinx.serialization. Para pruebas de API, Postman ayuda.
Preguntas frecuentes
¿Cómo funcionan las clases de datos Kotlin con JSON?
Una clase de datos Kotlin almacena datos estructurados con métodos equals, hashCode, toString y copy generados automáticamente. Librerías como Gson y kotlinx.serialization usan las propiedades de la clase para mapear campos JSON. Genera la clase de datos aquí, añade las anotaciones correctas y deserializa con Gson.fromJson o Json.decodeFromString.
¿Cómo parseo JSON con Retrofit en Kotlin?
Añade una factory de convertidor de Gson o kotlinx.serialization a tu builder de Retrofit, luego define tu interfaz de API con un tipo de retorno de clase de datos. Genera la clase de datos desde tu respuesta de API aquí, pégala en tu proyecto, y Retrofit manejará la deserialización automáticamente.
¿Cuál es la diferencia entre @SerializedName y @SerialName en Kotlin?
@SerializedName es para Gson y mapea una clave JSON a un nombre de propiedad Kotlin. @SerialName es el equivalente de kotlinx.serialization. Usa el que corresponda a tu librería JSON. Ambos permiten que claves JSON como user_name se mapeen a una propiedad Kotlin llamada userName.
¿Se envía mi JSON a un servidor?
No. La generación de clases de datos se ejecuta completamente en tu navegador. Tu JSON nunca sale de tu máquina.
¿Tipos nullable en clases de datos Kotlin?
Activa Nullable Types para generar String?, Int?, etc. Es útil cuando un campo JSON puede estar ausente o ser null. La seguridad de nulos de Kotlin significa que obtendrás un error de compilación si olvidas manejar estos casos.
Herramientas relacionadas
Para JSON en Kotlin, ver kotlinx.serialization y Gson. Para JSON, ver la especificación JSON y RFC 8259. Para una visión general, ver MDN.