Postman: un guía rápida para principiantes

¿Cómo usar Postman?

• Registro: Crea tu cuenta en Postman y accede al tablero inicial.

• Espacio de trabajo: Crea workspaces, organiza colecciones, APIs y variables.

• Realizar solicitudes: Crea una nueva petición. Guarda y envía.

• Colecciones: Agrupa peticiones relacionadas y ejecútalas secuencialmente.

• Consola: Depura y visualiza detalles de las peticiones.

• Pruebas: En la pestaña Test, ejecuta código JavaScript para evaluar respuestas.

Seguramente te has percatado que, en los últimos tiempos, Postman se ha posicionado como la herramienta de prueba todoterreno para hacer api testing. Esto debido, fundamentalmente, a que su interfaz de usuario intuitiva y amigable permite agrupar en un único escenario todas las posibles acciones de la estrategia API-first. En este entorno puedes describir, evaluar, documentar y monitorear un servicio API de forma sostenible y escalable, con facilidades añadidas para el trabajo en equipo.

¿Quieres incluir a Postman en tu grupo de habilidades adquiridas como QA Tester?

Entonces quédate, comenzamos con nuestra guía de iniciación para el uso de esta herramienta.

Paso 1: Crea tu cuenta y únete a la comunidad de Postman

Una vez que te registres y accedas a tu cuenta Postman, te encontrarás con un tablero inicial similar al que ves a continuación, donde por lo general tendrás acceso directo a tus entornos de trabajo, un historial de tu actividad, así como a las actualizaciones y despliegues más recientes de Postman.

Espacio de trabajo en Postman

El espacio de trabajo es una de las fortalezas de trabajar con Postman pues permite organizar colecciones, APIs, variables de entorno, monitores y demás elementos de un mismo proyecto, así como compartirlos con otros miembros de tu equipo de trabajo.

Para crear un nuevo espacio de trabajo solo tienes que desplegar el menú Workspaces> Create Workspace. Luego introduce un nombre para tu espacio y define quien o quienes tendrán acceso al mismo.

Una vez creado el espacio de trabajo, podrás encontrar a la izquierda una barra de acciones para navegar entre los diferentes elementos que componen tu espacio de trabajo. Si presionas el icono de más opciones podrás además identificar las posibles tareas para cada uno de los elementos.

Y ahora sí, viene la pregunta: ¿Cómo realizar solicitudes en Postman para conectarse con un determinado servicio API?

¡Simple! Solo debes crear una petición presionando el ícono de nueva peticióny definir el verbo, dirección del servicio, encabezados y cuerpo de la petición. Antes de hacer clic en el botón Enviar para ejecutar la petición, asegúrate de guardar la configuración de la misma.

Paso 2: Peticiones en Postman

Crea una nueva petición en tu recién creado espacio de trabajo tal y como te ilustramos en la imagen a continuación. Para este ejemplo utilizamos la API de prueba JSON Placeholder disponible de manera gratuita en esta dirección.

Ejecuta la petición.

¡Felicidades! Has realizado tu primera petición a una API con ayuda de Postman.

Añadamos ahora dos peticiones más.

Fíjate que debes establecer el parámetro id en la primera petición así como el cuerpo de la petición para la segunda tal y como te mostramos en las siguientes imágenes. Ejecútalas.

Si recibiste los estados http 200 y 201 para cada respuesta respectivamente, entonces has realizado con éxito estos dos últimos ejemplos.

¡Pasemos entonces al siguiente nivel!

Las colecciones en Postman

Como ves, realizar peticiones a un servicio con Postman es realmente sencillo. No obstante, y aunque en el ejemplo anterior se realiza una petición aleatoria al servicio, en la práctica diaria lo correcto es crear una colección de peticiones. En ellas, puedes agrupar las diferentes acciones que necesitas encuestar del servicio e incluso crear más de una colección dentro de tu espacio de trabajo si quieres construir diferentes escenarios para encuestar o evaluar las funcionalidades del servicio.

Si trabajas además en un proyecto con más de un servicio desplegado, disponer de una colección para cada uno de ellos resulta entonces aún más acertado. Con ello no solo se mantiene una estructura organizada y sencilla de documentar; también permite que otros miembros de tu equipo puedan trabajar de manera paralela en el proyecto.

IMPORTANTE - En Postman, las colecciones no sólo agrupan peticiones, también pueden ser un flujo de trabajo o un conjunto de pruebas. Sobre todo esto estaremos abordando con mayor profundidad en futuras publicaciones.

¿Cómo organizar y ejecutar mis colecciones en Postman?

Las peticiones de una colección pueden ser agrupadas en carpetas, quedando la jerarquía de ejecución definida por el orden de aparición de las peticiones en la estructura de las carpetas.

En Postman, ejecutar de manera secuencial las peticiones es posible con la ayuda del Collection Runner. Esta es una alternativa de ejecución manual a la cual accedes o bien a través del menú de opciones de cada colección o de manera directa en la barra inferior de tu espacio de trabajo.

En principio, la ejecución de las peticiones de una colección en el Collection Runner coinciden con la secuencia en que se ubican dentro de la colección. No obstante, el orden de la secuencia puede ser modificado previo a cada ejecución reposicionando las peticiones con solo arrastrar y soltar cada una de ellas.

Paso 3: Ejecutar secuencialmente una colección de peticiones

Presiona el botón Run JsonPlaceholder Example y observa la ejecución secuencial de cada una de las peticiones.

La consola en Postman

Una herramienta que no podemos dejar de mencionar en este básico de introducción a Postman es la Postman Console. Esta consola embebida en el escritorio de Postman te permite depurar una colección de peticiones o APIs, así como pruebas de APIs, que no se comportan tal y como se espera. En principio, es similar a la versión de navegador de la consola de desarrollador, excepto que está ajustada para el desarrollo de APIs. Cada vez que una petición se ejecuta, en la Postman Console se muestran la ruta exacta de la petición junto con sus encabezados, información de red y cargas útiles.

Con la Postman Console, también puedes mostrar mensajes o valores de variables que hayas definido en tus scripts y pre-request scripts, así como de variables globales o de entorno.

console.log(“nameOfVar”, valueOfVar);

Incluso puedes aprovechar los métodos info, warning y error para añadir estilo a tu mensaje. ¡Probemos!

Paso 4: Realiza un test en la consola de Postman

Abre la pestaña Test en la primera petición que ejecutaste. En esta área puedes ejecutar código en Javascript. Copia allí el siguiente segmento de código.

var statusResponse = pm.response.status;

if (statusResponse === "OK"){
	console.info("statusResponse", statusResponse);
}
else {
console.error("statusResponse is not OK");
}

Ahora ejecuta la petición y verás como aparece en la consola no solo la ruta de la petición sino también el mensaje correspondiente a su estado.

¡Postman te espera!

Como has podido comprobar Postman es una herramienta fácil de utilizar y muy útil durante el proceso de conceptualización, desarrollo y evaluación de una API.

Si finalizaste cada uno de los pasos de este tutorial estás sin duda preparado para comenzar a dar tus primeros pasos en Postman.

Por otro lado, si tu o tu equipo necesitáis ayuda con vuestras pruebas de API, en Redsauce somos una empresa de software, especialista en automatizarlas e integrarlas en los pipelines de desarrollo.

Este es el primer post de una serie de publicaciones sobre Postman que te ayudarán a seguir profundizando y dominando las funcionalidades de esta poderosa herramienta. ¡Suscríbete a nuestro blog o ven a visitar a visitarnos y serás el primero en enterarte!