Importer une collection Postman

Restorm importe les collections Postman v2.0 et v2.1 (le format que produit « Export ▸ Collection v2.1 » dans Postman).

Importer

Fichier ▸ Importer (Ctrl+I) puis le fichier .json exporté.

Ce qui est importé

Élément Postman	Ce que Restorm en fait
Dossiers (item imbriqués)	Des dossiers, à la même profondeur
Requêtes	Des requêtes HTTP — ou GraphQL quand le corps est de type graphql
Corps raw, formdata, urlencoded, file, graphql	Le type de corps correspondant
Variables de collection	Les variables d’un environnement
Descriptions	Les notes de la requête et la documentation d’API
Réponses d’exemple	La documentation d’API

Les scripts

C’est la partie qui distingue cet import. Vos scripts de pré-requête et de test ne sont pas perdus : ils sont conservés dans la documentation et convertis en un scénario exécutable dont les boîtes de code exécutent le script tel quel.

Restorm fournit pour cela une couche de compatibilité pm.* dans ses actions de code JavaScript : pm.environment, pm.variables, pm.response, pm.test, pm.expect, pm.sendRequest, pm.setNextRequest, pm.cookies… Vos assertions continuent donc de fonctionner sans réécriture.

L’authentification

Les blocs d’authentification Postman (oauth2, apikey, bearer, basic, digest, hawk, aws, ntlm, edgegrid) sont lus et résumés dans la documentation d’API, avec les valeurs sensibles masquées.

Ils ne sont pas convertis en identifiants exécutables : recréez une route d’authentification — c’est cinq minutes, et vous y gagnez le renouvellement automatique du jeton.

Mettre à jour

Postman fait partie des formats re-synchronisables (si la collection a été importée depuis une URL) : le bouton Actualiser du dossier récupère la source et Restorm applique le delta. Voir Mettre à jour depuis la source.

Aller plus loin

Le guide Migrer depuis Postman déroule la migration complète, y compris les environnements et les runners.