Convertisseur OpenAPI v2 vers v3

Convertisseur OpenAPI v2 vers v3

Collez une spécification Swagger 2.0 et obtenez une version valide de OpenAPI 3.0.3 sous forme de JSON ou YAML. Le convertisseur applique les règles officielles de correspondance structurale — déplaçant definitions sous components/schemas, regroupant host, basePathet schemes dans servers, divisant consumes et produces en cartes par opération content et reformulant les paramètres de formulaire et les définitions de sécurité — afin que votre spécification soit compatible avec les outils modernes d'OpenAPI.

Comment utiliser

1. Collez votre spécification Swagger 2.0 dans la zone d'entrée. JSON et YAML sont tous deux acceptés ; le format est détecté automatiquement.
2. Choisissez un format de sortie : conservez le format d'entrée ou forcez le JSON ou YAML.
3. Quitter Corriger les champs manquants pour compléter automatiquement les champs obligatoires de la version 3 comme info.title, info.version, et les descriptions des réponses manquantes lorsque la source v2 les omet.
4. Lisez le résumé de conversion et les avertissements affichés au-dessus du résultat, puis copiez ou téléchargez la spécification OpenAPI 3.0.3 résultante.

Caractéristiques

• Entrée en JSON ou YAML, sortie en JSON ou YAML — choisissez le format que vous préférez ou répétez celui d'entrée.
• Correspondance structurale — definitions → components/schemas, securityDefinitions → components/securitySchemes, parameters/responses sont déplacées sous components, et chaque $ref pointeur est réécrit pour correspondre.
• Serveurs à partir de host, basePath, schemes — combinés dans le tableau v3 servers avec HTTPS préféré lorsque plusieurs schémas sont listés.
• Négociation de contenu — consumes et produces sont traduites en cartes par opération requestBody.content et responses[*].content .
• Paramètres de corps et de formulaire — in: body devient un champ v3 requestBodyet in: formData les champs sont regroupés dans un multipart/form-data ou application/x-www-form-urlencoded schéma de corps de requête.
• Mise à jour du flux de sécurité — les valeurs OAuth2 flow sont réattribuées à l'objet v3 flows ()implicit, password, clientCredentials, authorizationCode).
• Mode de correction — lorsque activé, remplit les champs manquants afin que la sortie passe un validateur v3 au lieu de échouer à cause de défauts mineurs dans la source.
• Résumé de conversion et avertissements — comptage des chemins, des schémas et des schémas de sécurité convertis, ainsi que des avertissements pour tout ce qui ne peut pas être mappé de manière univoque.
• Fonctionne entièrement dans votre navigateur — votre spécification ne quitte jamais la page.