Convertisseur OpenAPI en collection Postman
Convertissez un document OpenAPI ou Swagger en une collection Postman v2.1 prête à importer.
Convertisseur OpenAPI en collection Postman
Collez un document OpenAPI 3 ou Swagger 2 — en JSON ou YAML — et cet outil construit une collection Postman v2.1 que vous pouvez importer directement dans Postman, Insomnia ou tout client qui lit le format. Chaque opération dans la spécification devient une demande, organisée en dossiers pour qu'une grande API reste navigable au lieu d'atterrir sous forme de liste plate.
Regroupez les demandes par tag ou par le premier segment de chemin, selon ce qui correspond à la façon dont votre équipe pense déjà à l'API. Activez « Insérer l'URL de base comme une variable d'environnement » pour remplacer l'URL du serveur par une variable {{baseUrl}}, afin que basculer entre la staging et la production soit un seul changement d'environnement au lieu de modifier chaque demande. « Ajouter des en-têtes d'authentification à partir du schéma de sécurité » lit les définitions bearer, clé API ou OAuth2 de la spécification et ajoute l'en-tête Authorization ou key correspondant comme un espace réservé. « Générer des corps de demande d'exemple à partir des schémas » crée un exemple JSON pour chaque demande à partir de son schéma, en suivant les références $ref dans le document, afin que les demandes POST et PUT arrivent pré-remplies au lieu d'être vides. Les paramètres de requête peuvent être inclus avec leurs descriptions, les points de terminaison obsolètes peuvent être complètement ignorés, et un script de test basique vérifiant un code de statut réussi peut être ajouté à chaque demande.
Les paramètres de chemin comme {id} deviennent automatiquement des variables de chemin Postman :id, et les fins de ligne CRLF et LF dans un document collé sont traitées de la même manière. Les grandes spécifications avec des centaines d'opérations se convertissent en une seule passe ; si la collection dépasserait la limite de sortie, elle l'indique au lieu de geler l'onglet.
Tout se passe localement dans votre navigateur — le document que vous collez, y compris tous les détails internes de l'API qu'il contient, n'est jamais téléchargé nulle part. Quand la collection est prête, copiez-la, téléchargez-la en tant que fichier, ou envoyez-la à l'entrée d'un autre outil pour continuer à travailler dessus.