JSON a Swift
Convertir JSON a estructuras POJO de Swift para desarrollo Swift
Entrada JSON
Salida Swift
¿Qué es JSON a Swift?
¿Estás construyendo una app iOS o macOS que llama a una REST API? Recibirás JSON — pero Swift necesita structs Codable explícitos para decodificarlo de forma segura. Escribir esos structs a mano para cada endpoint de API es repetitivo y propenso a errores. Esta herramienta genera structs Swift automáticamente desde tu JSON, con conformidad Codable incluida. Solo pega una respuesta de ejemplo y tendrás tipos listos para JSONDecoder de inmediato.
La conversión se ejecuta en tu navegador. Puedes configurar el nombre del struct y activar Usar Codable y Tipos opcionales. No se envía nada a ningún servidor. Los tipos generados son un punto de partida para proyectos iOS, macOS o Swift del lado del servidor.
Cuándo ayuda JSON a Swift
Al desarrollar apps iOS o macOS que consumen APIs REST, genera structs Codable aquí. Usa JSONDecoder para parsear. Pega una respuesta de ejemplo para obtener modelos tipados.
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 del struct raíz en la configuración. Activa Usar Codable para conformidad Codable y Tipos opcionales para campos opcionales.
Revisar los tipos generados
El panel derecho muestra structs o clases Swift. Los objetos anidados se convierten en tipos anidados. Usa JSONDecoder().decode(YourType.self, from: data) para parsear. Añade CodingKeys si las claves JSON difieren de los nombres de propiedad. Para JSON inválido, usa primero el Validador JSON.
Copiar o descargar
Usa Copiar o Descargar. Para formatear JSON primero, usa el Formateador JSON. Para validación, usa el Validador JSON.
Ejemplos de JSON a Swift
Aquí un ejemplo de generación de structs Swift desde un objeto JSON.
Ejemplo: Registro de suscriptor
Entrada JSON:
Salida Swift generada:
Cuándo ayuda JSON a Swift
Al desarrollar apps iOS o macOS que consumen APIs REST, necesitas tipos Swift para el payload de respuesta. Pegar una respuesta de ejemplo aquí te da structs Codable para usar con URLSession o Alamofire. Swift del lado del servidor (Vapor, Kitura) se beneficia del mismo flujo. Escribir structs manualmente para JSON anidado complejo es propenso a errores; esta herramienta infiere la estructura desde tu ejemplo. Para extraer valores específicos de respuestas grandes primero, usa jq desde la línea de comandos. Para validación, usa el Validador JSON.
Preguntas frecuentes
¿Qué es un struct Codable en Swift?
Codable es un typealias para Encodable & Decodable. Un struct Codable puede convertirse hacia/desde JSON usando el JSONDecoder y JSONEncoder integrados de Swift. Es la forma moderna y recomendada de manejar JSON en apps iOS y macOS. Ver la guía Codable de Apple.
¿Cómo decodifico JSON en Swift?
Crea un struct Codable que coincida con tu JSON, luego llama JSONDecoder().decode(YourType.self, from: data). Genera el struct aquí — pega tu JSON y copia el resultado en tu proyecto Xcode.
¿Struct vs clase para modelos JSON en Swift?
Los structs son tipos valor y se prefieren para DTOs y modelos JSON en Swift — son más simples, seguros para hilos y funcionan bien con Codable. Usa clases cuando necesites semántica de referencia o herencia.
¿Se envían mis datos JSON a un servidor?
No. La generación de structs se ejecuta completamente en tu navegador. Tu JSON nunca sale de tu dispositivo, así que es seguro para claves API o payloads sensibles.
¿Puedo usar esto con Alamofire?
Sí. El responseDecodable(of: YourType.self) de Alamofire funciona con cualquier tipo Codable. Genera el struct aquí e intégralo directamente en tu handler de respuesta de Alamofire.
Herramientas relacionadas
Swift Codable. JSONDecoder. especificación JSON. RFC 8259. MDN.