# OpenAPI vers Postman Collection Convertit une spec OpenAPI 3.x ou Swagger 2.0 (JSON/YAML) en Postman Collection v2.1.0 importable avec dossiers, variables, auth et réponses d'exemple. > Page canonique: https://elysiatools.com/fr/tools/openapi-to-postman-collection - **Catégorie:** Development - **Mots-clés:** openapi vers postman, swagger vers postman, import postman, convertisseur openapi, test api, newman ## Présentation Collez la spec, téléchargez la collection, importez-la dans Postman (Import → File) ou lancez-la avec Newman — aucun package Node à installer. Le convertisseur suit les conventions d'openapi-to-postman : servers[0] devient la variable {{baseUrl}} (slashs finaux retirés, serveurs supplémentaires en baseUrl_2…, variables de serveur comme {port} deviennent des variables de collection) ; les dossiers par chemins forment un trie replié (ou utilisez les tags) ; les paramètres de chemin deviennent des segments :param plus url.variable ; les paramètres query/header reçoivent un préfixe “(Required) ” et des indices d'enum ; les corps JSON sont générés avec des valeurs déterministes (example → premier enum → default → selon format → heuristiques comme user@example.com) ; des réponses d'exemple sont enregistrées par code ; les schémas bearer/basic/apiKey deviennent l'auth de collection référençant {{bearerToken}}/{{apiKey}}. Swagger 2.0 passe par une couche de compatibilité. Les paramètres cookie sont ignorés avec un avertissement. ## Entrées - **Spécification OpenAPI / Swagger (JSON ou YAML)** (textarea): { "openapi": "3.0.3", "info": { "title": "My API" }, … - **Stratégie de dossiers** (select) - **Inclure des réponses d'exemple** (checkbox) - **Convertir les schémas de sécurité en auth** (checkbox) ## Quand l'utiliser - Vous souhaitez tester rapidement une nouvelle API documentée en OpenAPI ou Swagger dans l'application Postman. - Vous devez exécuter des tests automatisés avec Newman dans un pipeline CI/CD à partir d'une spec OpenAPI. - Vous voulez partager une collection Postman organisée et préconfigurée (auth, exemples, variables) avec votre équipe de développement ou de QA. ## Fonctionnement - Collez le contenu de votre spécification OpenAPI 3.x ou Swagger 2.0 au format JSON ou YAML dans le champ prévu. - Sélectionnez la stratégie d'organisation des dossiers (par chemins d'URL ou par balises/tags) et cochez les options d'exemples et d'authentification. - Téléchargez le fichier JSON généré au format Postman Collection v2.1.0. - Importez le fichier directement dans Postman (Import → File) ou transmettez-le à Newman pour exécuter vos requêtes. ## Cas d'usage - Transformation d'une spécification Swagger 2.0 legacy en collection Postman moderne avec gestion des jetons Bearer. - Génération de requêtes de test avec des corps JSON types pour valider des endpoints REST complexes. - Préparation de collections pour l'automatisation de tests d'intégration via le CLI Newman dans GitHub Actions ou GitLab CI. ## Questions fréquentes ### Quels formats d'entrée sont acceptés par le convertisseur ? L'outil accepte les spécifications OpenAPI 3.x et Swagger 2.0, rédigées en JSON ou en YAML. ### Comment l'URL du serveur est-elle gérée dans la collection Postman ? La première URL de serveur devient la variable de collection {{baseUrl}} (sans slash final), et les serveurs additionnels sont enregistrés sous {{baseUrl_2}}, etc. ### Quelles méthodes d'authentification sont prises en charge ? Les schémas de sécurité HTTP Bearer, Basic et API Key sont automatiquement mappés vers l'authentification de collection via les variables {{bearerToken}} et {{apiKey}}. ### Comment choisir entre l'organisation par chemins et par balises ? L'option 'Par chemins' crée une arborescence basée sur les segments d'URL, tandis que l'option 'Par balises' regroupe les requêtes selon les tags OpenAPI définis. ### Les paramètres de type Cookie sont-ils inclus dans la collection ? Non, le format de collection Postman ne permet pas d'exprimer nativement les paramètres cookies dans les requêtes ; ils sont ignorés. ## Outils associés - [Visualiseur des differences de configuration denvironnement](https://elysiatools.com/fr/tools/environment-config-diff-visualizer): Compare des configurations JSON, YAML, TOML et ENV entre environnements en mettant en evidence la derive, les cles manquantes et les pistes de nettoyage. - [Generateur OpenAPI vers TypeScript](https://elysiatools.com/fr/tools/openapi-to-typescript-generator): Convertit des specifications OpenAPI ou Swagger JSON/YAML en types TypeScript, parametres de requete et modeles de reponse avec format et style de nommage configurables - [De la palette d’image aux design tokens](https://elysiatools.com/fr/tools/image-to-design-tokens): Extrait les couleurs dominantes d’une image par k-means et les exporte en variables CSS / SCSS / config Tailwind / tokens JSON, avec noms et échelle de teintes - [Générateur de Graphique d'Intervalle](https://elysiatools.com/fr/tools/range-chart-generator): Créer des graphiques d'intervalles pour visualiser les plages de valeurs min-max avec marqueurs de médiane et détection de valeurs aberrantes - [Convertisseur JSON Schema vers Zod](https://elysiatools.com/fr/tools/json-schema-to-zod-schema-converter): Convertit des definitions JSON/YAML de JSON Schema en code Zod pret a lemploi dans les projets TypeScript, avec objets imbriques, tableaux, enums et regles de validation courantes - [Etiquettes PDF QR/Code-barres](https://elysiatools.com/fr/tools/pdf-qr-barcode-labels): Genere des etiquettes PDF en lot avec QR et code-barres - [Suppresseur de Caractères BOM](https://elysiatools.com/fr/tools/data-bom-remover): Supprimer les caractères BOM (Byte Order Mark) du contenu textuel et des fichiers. Parfait pour nettoyer les fichiers texte avec des problèmes d'encodage. - [Limiteur de Plage de Données](https://elysiatools.com/fr/tools/data-range-limiter): Limiter les valeurs numériques à des plages spécifiées en coupant, filtrant ou marquant les valeurs hors limites. Parfait pour le contrôle de qualité des données. ## Exemples - [Exemples OpenAPI/Swagger](https://elysiatools.com/fr/samples/openapi-swagger): Exemples complets de documentation API utilisant OpenAPI 3.0 et les spécifications Swagger pour les services RESTful - [Exemples de Traçage Distribué](https://elysiatools.com/fr/samples/distributed-tracing-samples): Exemples complets de traçage distribué utilisant Jaeger, OpenTelemetry et outils d'observabilité modernes - [Outil de Bundling Parcel](https://elysiatools.com/fr/samples/parcel): Exemples de l'outil de bundling Parcel de configuration zéro incluant la configuration de projet, les plugins et la configuration avancée - [Exemples de pnpm Package Manager](https://elysiatools.com/fr/samples/pnpm): Exemples de gestionnaire de paquets rapide et économe en espace disque incluant monorepo, configuration workspace, et workflows avancés ## Contenu associé - [Outils d interchange JSON et de traduction de formats](https://elysiatools.com/fr/hubs/json-convert): Comparez les outils de conversion JSON pour CSV, YAML, TOML, GraphQL, XML, Markdown, Excel, BSON, EDN et d autres formats structures dans un meme hub. - [Outils d inspection, de diff et de transformation JSON](https://elysiatools.com/fr/hubs/json-utility): Regroupe dans un meme hub les outils de formatage JSON, comparaison, inspection de chemins, validation de schema, fusion et transformation pour les workflows API et donnees. - [Generateurs de schemas JSON, donnees mock et fixtures API](https://elysiatools.com/fr/hubs/json-generate): Des outils reunis pour generation de schemas JSON, construction de payloads mock et preparation de fixtures API dans un seul hub. - [Outils de formatage, de diff et de normalisation JSON](https://elysiatools.com/fr/hubs/json-format): Comparez les outils de formatage JSON, diff, revue de logs, comparaison de configuration et normalisation de données dans un hub unique pour les workflows JSON lisibles et vérifiables.