Postman para principiantes: qué es y cómo hacer tu primera prueba de API

Por /

Postman es esencial para cualquier QA Engineer, y es de lo primero que aprendí en mi formación. Una vez que lo tienes instalado y entiendes cómo funciona, se convierte en una herramienta que usas en prácticamente todos los proyectos. En este artículo te explico qué es, para qué sirve y cómo hacer tu primera prueba de API desde cero.

Qué es Postman

Postman es una herramienta que permite enviar peticiones HTTP a APIs y ver las respuestas que devuelven. En pocas palabras: es la forma más cómoda de probar que una API funciona correctamente sin necesidad de escribir código.

Es gratuita, tiene versión de escritorio para Windows, Mac y Linux, y no necesitas saber programar para empezar a usarla.

Para qué sirve en el día a día de un QA

En un proyecto real, el QA Engineer usa Postman para varias cosas.

Para explorar la API antes de escribir los tests. Cuando te llega una API nueva, lo primero es entender cómo funciona: qué endpoints tiene, qué parámetros acepta, qué devuelve. Postman te permite hacer eso de forma visual y rápida.

Para validar que los endpoints responden correctamente. Compruebas que el status code es el esperado, que la estructura del JSON es correcta y que los datos devueltos tienen sentido.

Para crear colecciones de tests automáticos. Postman permite añadir scripts de validación a cada petición para que se ejecuten automáticamente. Así puedes montar una suite de tests de API sin escribir una sola línea de código Python.

Para compartir el trabajo con el equipo. Las colecciones de Postman se pueden exportar y compartir, lo que facilita la colaboración con desarrolladores y otros QA.

Cómo instalar Postman

Ve a postman.com, descarga la versión de escritorio para Windows y sigue el proceso de instalación normal. Puedes crear una cuenta gratuita o usarlo sin cuenta — aunque con cuenta puedes guardar tus colecciones en la nube.

Conceptos básicos que necesitas conocer

Antes de hacer tu primera petición, hay cuatro conceptos que tienes que tener claros.

Endpoint: la URL a la que envías la petición. Por ejemplo: https://api.ejemplo.com/users

Método HTTP: el tipo de operación que quieres realizar. Los más comunes son GET (obtener datos), POST (crear), PUT (actualizar) y DELETE (eliminar).

Status code: el código que devuelve la API para indicar si la petición fue correcta o no. Los más importantes son 200 (OK), 201 (creado), 400 (petición incorrecta), 401 (no autorizado), 404 (no encontrado) y 500 (error del servidor).

Body: el contenido que envías con la petición, normalmente en formato JSON. Se usa en peticiones POST y PUT.

Tu primera petición en Postman

Vamos a hacer una petición real a una API pública de pruebas. Abre Postman y sigue estos pasos.

Haz clic en New → HTTP Request.

En el campo de método selecciona GET.

En el campo de URL escribe:

https://jsonplaceholder.typicode.com/users/1

Pulsa Send.

En la parte inferior verás la respuesta de la API. Debería ser un JSON con datos de un usuario y un status code 200 OK.

Acabas de hacer tu primera prueba de API. 🎉

Cómo añadir tests automáticos en Postman

Postman permite añadir scripts de validación a cada petición para que se ejecuten automáticamente cada vez que la lanzas. Esto es lo que convierte Postman de una herramienta de exploración en una herramienta de testing real.

En la petición que acabas de crear, haz clic en la pestaña Tests y escribe esto:

javascript

pm.test("Status code es 200", function () {
    pm.response.to.have.status(200);
});

pm.test("El body contiene id", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.id).to.eql(1);
});

pm.test("El tiempo de respuesta es menor de 500ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(500);
});
```

Pulsa **Send** de nuevo. En la pestaña **Test Results** verás si los tests han pasado o fallado.

---

### Qué son las colecciones y por qué usarlas

Una colección es un conjunto de peticiones organizadas en carpetas. Es la forma de estructurar los tests de API en Postman de manera que sean fáciles de mantener y ejecutar.

Para crear una colección haz clic en **Collections** en el panel izquierdo → **New Collection**. Dale un nombre y empieza a añadir peticiones.

Una colección bien organizada puede tener carpetas por funcionalidad: autenticación, usuarios, productos, pagos. Cada carpeta con sus peticiones y sus tests correspondientes.

---

### Variables de entorno: imprescindibles en proyectos reales

Las variables de entorno permiten cambiar la URL base u otros parámetros sin tocar cada petición individualmente. Muy útil cuando tienes entornos de desarrollo, staging y producción.

Para crear una variable de entorno ve a **Environments** → **New Environment**. Añade una variable llamada `base_url` con el valor `https://jsonplaceholder.typicode.com`.

Luego en tus peticiones usa la variable así:
```
{{base_url}}/users/1

Si necesitas cambiar el entorno, solo cambias el valor de la variable y todas las peticiones se actualizan automáticamente.

El siguiente paso

Con Postman controlado ya tienes una herramienta potente para testear APIs de forma manual y automatizada. Si quieres ver un ejemplo real de colección de Postman en un proyecto completo, puedes visitar mi GitHub.

En el siguiente artículo del blog explico cómo configurar GitHub Actions para ejecutar tus tests automáticamente cada vez que hay un cambio en el código, que es el siguiente paso natural para cualquier QA que quiera trabajar con CI/CD.

Si necesitas ayuda con API Testing o automatización en tu proyecto, puedes ver mis servicios en fatimaqa.com. Y si quieres saber más sobre cuándo tiene sentido incorporar QA a tu equipo, puedes leer cuándo necesita tu startup un QA Tester.

Scroll al inicio