Ir al contenido

Importar una colección de Postman

Restorm importa las colecciones Postman v2.0 y v2.1 (el formato que produce «Export ▸ Collection v2.1» en Postman).

Archivo ▸ Importar (Ctrl+I) y después el archivo .json exportado.

El árbol producido por la importación de una colección de Postman: una carpeta de variables en la raíz, una subcarpeta por cada carpeta de Postman y una petición por entrada con su verbo

Elemento de PostmanLo que Restorm hace con él
Carpetas (item anidados)Carpetas, a la misma profundidad
PeticionesPeticiones HTTP, o GraphQL cuando el cuerpo es de tipo graphql
Cuerpos raw, formdata, urlencoded, file, graphqlEl tipo de cuerpo correspondiente
Variables de colecciónLas variables de un entorno
DescripcionesLas notas de la petición y la documentación de API
Respuestas de ejemploLa documentación de API

Es la parte que distingue esta importación. Sus scripts de pre-petición y de prueba no se pierden: se conservan en la documentación y se convierten en un escenario ejecutable cuyas cajas de código ejecutan el script tal cual.

Para ello, Restorm proporciona una capa de compatibilidad pm.* en sus acciones de código JavaScript: pm.environment, pm.variables, pm.response, pm.test, pm.expect, pm.sendRequest, pm.setNextRequest, pm.cookies… Sus aserciones siguen funcionando, por tanto, sin necesidad de reescribirlas.

Los bloques de autenticación de Postman (oauth2, apikey, bearer, basic, digest, hawk, aws, ntlm, edgegrid) se leen y resumen en la documentación de API, con los valores sensibles ocultos.

No se convierten en credenciales ejecutables: vuelva a crear una ruta de autenticación —son cinco minutos, y a cambio obtiene la renovación automática del token—.

Postman forma parte de los formatos resincronizables (si la colección se importó desde una URL): el botón Actualizar de la carpeta recupera el origen y Restorm aplica el delta. Consulte Actualizar desde el origen.

La guía Migrar desde Postman desarrolla la migración completa, incluidos los entornos y los runners.