Salta ai contenuti

Importare una collezione Postman

Restorm importa le collezioni Postman v2.0 e v2.1 (il formato prodotto da «Export ▸ Collection v2.1» in Postman).

File ▸ Importa (Ctrl+I) e poi il file .json esportato.

L’albero prodotto dall’importazione di una collezione Postman: una cartella di variabili nella radice, una sottocartella per ogni cartella Postman e una richiesta per voce con il suo verbo

Elemento PostmanCiò che Restorm ne fa
Cartelle (item annidati)Cartelle, alla stessa profondità
RichiesteRichieste HTTP — oppure GraphQL quando il corpo è di tipo graphql
Corpi raw, formdata, urlencoded, file, graphqlIl tipo di corpo corrispondente
Variabili di collezioneLe variabili di un ambiente
DescrizioniLe note della richiesta e la documentazione di API
Risposte di esempioLa documentazione di API

È la parte che distingue questa importazione. Gli script di pre-richiesta e di test non vanno perduti: vengono conservati nella documentazione e convertiti in uno scenario eseguibile i cui riquadri di codice eseguono lo script così com’è.

Per questo Restorm fornisce un livello di compatibilità pm.* nelle sue azioni di codice JavaScript: pm.environment, pm.variables, pm.response, pm.test, pm.expect, pm.sendRequest, pm.setNextRequest, pm.cookies… Le asserzioni continuano quindi a funzionare senza riscritture.

I blocchi di autenticazione di Postman (oauth2, apikey, bearer, basic, digest, hawk, aws, ntlm, edgegrid) vengono letti e riassunti nella documentazione di API, con i valori sensibili mascherati.

Non vengono convertiti in credenziali eseguibili: occorre ricreare una rotta di autenticazione — sono cinque minuti, e in cambio si ottiene il rinnovo automatico del token.

Postman fa parte dei formati risincronizzabili (se la collezione è stata importata da un URL): il pulsante Aggiorna della cartella recupera la sorgente e Restorm applica il delta. Si veda Aggiornare dalla sorgente.

La guida Migrare da Postman illustra l’intera migrazione, compresi gli ambienti e i runner.