JSON vers Swift
Convertir JSON en structs POJO Swift pour le développement Swift
Entrée JSON
Sortie Swift
Qu'est-ce que JSON vers Swift ?
Vous créez une app iOS ou macOS qui appelle une REST API ? Vous recevrez du JSON — mais Swift a besoin de structs Codable explicites pour le décoder en toute sécurité. Écrire ces structs à la main pour chaque endpoint d'API est répétitif et source d'erreurs. Cet outil génère automatiquement des structs Swift depuis votre JSON, avec la conformité Codable incluse. Collez simplement un exemple de réponse et vous obtiendrez des types prêts pour JSONDecoder immédiatement.
La conversion s'exécute dans votre navigateur. Vous pouvez définir le nom du struct et activer Utiliser Codable et Types optionnels. Rien n'est envoyé à un serveur. Les types générés sont un point de départ pour les projets iOS, macOS ou Swift côté serveur.
Quand JSON vers Swift aide
Lors du développement d'apps iOS ou macOS qui consomment des APIs REST, générez des structs Codable ici. Utilisez JSONDecoder pour parser. Collez une réponse d'exemple pour obtenir des modèles typés.
Comment utiliser cet outil
Coller ou importer JSON
Collez votre JSON dans l'éditeur de gauche ou importez un fichier. Utilisez Exemple pour des données d'exemple. Définissez le Nom du struct racine dans la configuration. Activez Utiliser Codable pour la conformité Codable et Types optionnels pour les champs optionnels.
Vérifier les types générés
Le panneau de droite affiche les structs ou classes Swift. Les objets imbriqués deviennent des types imbriqués. Utilisez JSONDecoder().decode(YourType.self, from: data) pour parser. Ajoutez CodingKeys si les clés JSON diffèrent des noms de propriété. Pour un JSON invalide, utilisez d'abord le Validateur JSON.
Copier ou télécharger
Utilisez Copier ou Télécharger. Pour formater le JSON d'abord, utilisez le Formatage JSON. Pour la validation, utilisez le Validateur JSON.
Exemples JSON vers Swift
Voici un exemple de génération de structs Swift à partir d'un objet JSON.
Exemple : Enregistrement abonné
Entrée JSON :
Sortie Swift générée :
Quand JSON vers Swift aide
Lors du développement d'apps iOS ou macOS qui consomment des APIs REST, vous avez besoin de types Swift pour le payload de réponse. Coller une réponse d'exemple ici vous donne des structs Codable à utiliser avec URLSession ou Alamofire. Swift côté serveur (Vapor, Kitura) bénéficie du même flux. Écrire manuellement des structs pour du JSON imbriqué complexe est sujet aux erreurs ; cet outil infère la structure depuis votre exemple. Pour extraire des valeurs spécifiques de grandes réponses, utilisez jq en ligne de commande. Pour la validation, utilisez le Validateur JSON.
Questions fréquentes
Qu'est-ce qu'un struct Codable en Swift ?
Codable est un typealias pour Encodable & Decodable. Un struct Codable peut être converti vers/depuis JSON en utilisant le JSONDecoder et JSONEncoder intégrés de Swift. C'est la façon moderne et recommandée de gérer JSON dans les apps iOS et macOS. Voir le guide Codable d'Apple.
Comment décoder du JSON en Swift ?
Créez un struct Codable qui correspond à votre JSON, puis appelez JSONDecoder().decode(YourType.self, from: data). Générez le struct ici — collez votre JSON et copiez le résultat dans votre projet Xcode.
Struct vs classe pour les modèles JSON en Swift ?
Les structs sont des types valeur et sont préférés pour les DTOs et les modèles JSON en Swift — ils sont plus simples, thread-safe et fonctionnent bien avec Codable. Utilisez des classes quand vous avez besoin de sémantique de référence ou d'héritage.
Mes données JSON sont-elles envoyées à un serveur ?
Non. La génération de structs s'exécute entièrement dans votre navigateur. Votre JSON ne quitte jamais votre appareil, donc c'est sûr pour les clés API ou les payloads sensibles.
Puis-je l'utiliser avec Alamofire ?
Oui. Le responseDecodable(of: YourType.self) d'Alamofire fonctionne avec tout type Codable. Générez le struct ici et intégrez-le directement dans votre handler de réponse Alamofire.
Outils connexes
Swift Codable. JSONDecoder. spécification JSON. RFC 8259. MDN.