Migrar desde Postman
1. Exportar desde Postman
Section titled “1. Exportar desde Postman”En Postman: Collection ▸ … ▸ Export ▸ Collection v2.1. Haga lo mismo con sus entornos.
2. Importar en Restorm
Section titled “2. Importar en Restorm”Archivo ▸ Importar (Ctrl+I) y después el archivo JSON. Restorm detecta el formato por sí
solo.
Más detalles: Importar una colección de Postman.
Lo que pasa automáticamente
Section titled “Lo que pasa automáticamente”| Postman | Restorm |
|---|---|
| Carpetas | Carpetas, a la misma profundidad |
| Peticiones HTTP | Peticiones HTTP |
| Peticiones GraphQL | Peticiones GraphQL (no peticiones HTTP) |
| Cuerpos raw, formdata, urlencoded, file, graphql | El tipo de cuerpo correspondiente |
| Variables de colección | Variables de un entorno |
| Descripciones | Notas y documentación de API |
| Respuestas de ejemplo | Documentación de API |
| Scripts de pre-petición y pruebas | Un escenario ejecutable, con la capa pm.* |
Lo que requiere un ajuste
Section titled “Lo que requiere un ajuste”La autenticación
Section titled “La autenticación”Los bloques de autenticación de Postman se documentan (con los valores sensibles ocultos) pero no se convierten en credenciales ejecutables.
Vuelva a crear una petición de autenticación: es cuestión
de cinco minutos, y a cambio obtiene la renovación automática del token y el reintento ante un
401, que Postman no hace por sí solo.
Los entornos
Section titled “Los entornos”Expórtelos desde Postman y vuelva a crearlos en una carpeta de variables.
Aproveche para usar los subentornos: allí donde Postman impone un entorno plano por destino, Restorm permite una base común y sobrescrituras por cliente o por región.
Los runners y Newman
Section titled “Los runners y Newman”Es el reemplazo más rentable. Un escenario hace lo que hace un runner, pero mejor:
- el flujo es visible en lugar de ser un orden de colección implícito;
- las ramificaciones, los bucles y los reintentos son cajas, no
pm.setNextRequest; - la ejecución en CI está integrada, con códigos de salida limpios: consulte Ejecución headless y CI.
Equivalencias de conceptos
Section titled “Equivalencias de conceptos”| Postman | Restorm |
|---|---|
| Workspace | Un proyecto .restorm, versionado en git |
| Collection | Una carpeta o una carpeta de variables |
| Environment | Un entorno dentro de una carpeta de variables |
| Globals | Un entorno raíz, heredado por sus hijos |
| Pre-request / Test script | Un escenario, o una acción de código |
| Collection Runner | Un escenario |
| Newman | restorm --run --headless |
| Mock Server | El modo servidor, en local |
| Monitors | Una acción Temporizador, o una tarea programada de su CI |
| Postman Console | La consola |
Variables dinámicas {{$random…}} | Las mismas, más 116 helpers: consulte la referencia |
La diferencia de fondo
Section titled “La diferencia de fondo”Sus peticiones se convierten en archivos de su repositorio. Siguen el mismo ciclo de revisión que su código, su historial es el historial de git y los permisos de acceso son los de su forja.
No hay ningún espacio de trabajo alojado que administrar, ni ningún dato de API en un servicio
ajeno. Consulte
Proyectos y archivos .restorm.
Y lo que Postman tiene y Restorm no
Section titled “Y lo que Postman tiene y Restorm no”Para ser honestos: Restorm no tiene ningún espacio de trabajo colaborativo alojado, ni portal de API público, ni comentarios en línea sobre las peticiones, ni monitorización alojada. Si su organización se apoya en estos elementos, no tienen equivalente directo: la compartición pasa por git.