Importer

Echolot importe dans un espace de travail ce que vous avez déjà dans d’autres outils : requêtes, dossiers, authentification, variables, environnements et scripts. Il détermine le format d’après le contenu, place les identifiants dans le trousseau et vous indique dans un rapport ce qu’il n’a pas pu reprendre.

Ce qu’Echolot importeCopy Anchor Link

Une collection, une spec, un fichier HAR ou un dossier Bruno arrive dans un dossier à part, qui porte son nom. Une commande cURL devient une seule requête.

Les configs de serveurs MCP de Claude Desktop, Claude Code, Cursor, VS Code et Codex s’importent aussi, comme serveurs MCP : voir Ajouter des serveurs.

Importer dans l’appCopy Anchor Link

Choisissez l’une de ces méthodes. L’import va dans le dossier sélectionné dans la barre latérale, ou en haut de l’espace de travail.

• Fichier › Importer… (⇧⌘I), ou Importer… dans le menu + de la barre latérale ou dans la palette de commandes. Choisissez un ou plusieurs fichiers, ou un dossier de collection Bruno.
• Déposez des fichiers ou un dossier Bruno n’importe où sur le panneau de contenu de la fenêtre, ou sur un dossier de la barre latérale.
• Collez une commande cURL, ou le texte d’une collection ou d’une spec, dans la barre latérale (⌘V avec la barre latérale active).
• Collez une commande cURL dans le champ d’adresse d’une requête. Celle-ci ne crée pas de requête : elle remplace la méthode, l’adresse, les en-têtes, le corps, l’authentification et les réglages de la requête ouverte, et en garde le nom et la place. Ce qui n’a pas pu être utilisé est listé sous la barre d’adresse comme Notes cURL.

Le rapport d’importCopy Anchor Link

Après un import, un rapport s’ouvre. Son titre dit ce qui est arrivé (« 22 requêtes, 7 dossiers importés ») ; en dessous, de quels formats cela vient et si tout a été importé. Puis, pour chaque fichier :

• Notes sur tout ce qui n’a pas pu être repris tel quel. Rien n’est abandonné sans note.
• Secrets : les noms des valeurs enregistrées dans le trousseau plutôt que dans les fichiers. Jamais les valeurs.

Afficher dans la barre latérale sélectionne ce qui a été importé ; Terminé ferme le rapport. Une seule commande cURL sans rien à signaler s’ouvre directement, sans rapport.

Les secrets vont dans le trousseauCopy Anchor Link

Les fichiers de l’espace de travail ne reçoivent jamais de mot de passe, de jeton ou de clé en clair, vous pouvez donc les valider dans Git.

• Les identifiants saisis dans les requêtes (dans l’authentification, dans un en-tête Authorization, dans un en-tête de clé d’API) deviennent des variables secrètes, nommées d’après la requête et le champ. Par exemple, curl -u heidi:alpenglow https://demo.echolot.dev/echo/basic-auth/heidi/alpenglow crée une requête nommée heidi-alpenglow dont le mot de passe est {{heidi_alpenglow_password}} ; la valeur va dans le trousseau.
• Les valeurs secrètes des environnements et des collections vont dans le trousseau de la même façon.

Les identifiants présents dans les chaînes de requête des adresses, dans les corps et dans les adresses user:password@ ne sont pas encore déplacés : vérifiez-les avant de valider un espace de travail importé. Voir Secrets.

ScriptsCopy Anchor Link

Les scripts de pré-requête et de test de Postman sont repris et s’exécutent dans le sandbox pm.* d’Echolot. L’app n’exécute les scripts importés qu’après que vous leur avez fait confiance : le rapport indique combien il y en avait, et le premier envoi qui en a besoin vous demande de les examiner (Examiner les scripts…). Les scripts et les tests de Bruno sont repris tels qu’écrits, mais bru, req et res de Bruno ne sont pas le pm de Postman, ils peuvent donc demander des corrections avant de s’exécuter. Voir Scripts et tests.

Ce qui n’est pas reprisCopy Anchor Link

Le rapport nomme chacun de ces cas quand il se présente :

Les fichiers OpenAPI restent liésCopy Anchor Link

L’import d’un fichier OpenAPI ou Swagger en garde aussi une copie dans le dossier specs/ de l’espace de travail, et le nouveau dossier de requêtes suit cette spec : quand la spec change, Echolot peut montrer ce qui a changé et l’appliquer aux requêtes. Modifiez la spec sur la page Specs.

Importer en ligne de commandeCopy Anchor Link

echolot import accepte les mêmes formats dans un dossier d’espace de travail, pour que vous puissiez scripter une migration ou importer en CI :

echolot import Alpenglow.postman_collection.json -w "Alpenglow.echolot"
echolot import staging.postman_environment.json -w "Alpenglow.echolot"
echolot import openapi.yaml -w "Alpenglow.echolot" --folder catalog
pbpaste | echolot import - -w "Alpenglow.echolot"       # a cURL command from the clipboard

Il détecte le format d’après le contenu ; --format désactive la détection (curl, postman-collection, postman-environment, openapi, swagger, insomnia, har, paw ou mcp-config). Il affiche le même rapport :

Imported 22 requests, 7 folders from Postman collection v2.1.
warning: 19 pre-request or test scripts were imported; Echolot runs them once you trust them.

Sur un Mac, les secrets vont dans le trousseau comme dans l’app. Là où il n’y a pas de trousseau (Linux, ou ECHOLOT_KEYCHAIN=0), ils restent hors des fichiers, et l’outil indique quelles variables ECHOLOT_SECRET_<NAME> définir là où vous envoyez. L’outil en ligne de commande exécute lui-même tous les scripts sans demander, comme le fait Newman.

Vous n’avez pas besoin d’importer une collection Postman pour l’exécuter : echolot run collection.json l’exécute telle quelle. Voir Import et export et echolot run.

Pour faire le chemin inverse, voir Exporter.