Las API son una parte fundamental de muchas aplicaciones y servicios que utilizamos a diario. Una aplicación móvil, una tienda online o una página web pueden comunicarse con un servidor mediante una API para consultar información, crear registros, iniciar sesión o realizar diferentes operaciones.

Para trabajar con estas interfaces existen herramientas que permiten enviar peticiones y comprobar las respuestas de los servidores. Una de las más conocidas es Postman, una plataforma especialmente utilizada por desarrolladores para crear, probar, documentar y trabajar con API.

Pero ¿qué es exactamente Postman? ¿Para qué sirve? ¿Y cómo podemos utilizarlo por primera vez?

¿Qué es Postman?

Postman es una plataforma para desarrollar, probar, gestionar y utilizar API. Aunque inicialmente se hizo especialmente popular como cliente para enviar peticiones a API, actualmente ofrece muchas más herramientas relacionadas con el ciclo de desarrollo de estas interfaces.

Con Postman podemos crear una petición indicando una dirección URL, seleccionar el método HTTP, añadir parámetros, cabeceras o datos y enviarla a un servidor.

Después, Postman muestra la respuesta recibida para que podamos analizarla.

Por ejemplo, imaginemos una API que proporciona información sobre productos. Podríamos enviar una petición como:

GET https://ejemplo.com/api/productos

El servidor podría devolver una respuesta en formato JSON:

{
  "productos": [
    {
      "id": 1,
      "nombre": "Producto de ejemplo"
    }
  ]
}

Postman permite visualizar esta información directamente y comprobar si la API está funcionando como esperamos.

¿Para qué sirve Postman?

Postman puede utilizarse para numerosas tareas relacionadas con las API.

Entre las más habituales están:

• Enviar peticiones HTTP.
• Probar API.
• Consultar respuestas de servidores.
• Crear usuarios o registros mediante peticiones POST.
• Modificar información.
• Eliminar recursos.
• Probar sistemas de autenticación.
• Utilizar variables y diferentes entornos.
• Crear colecciones de peticiones.
• Escribir pruebas automáticas.
• Documentar API.
• Ejecutar conjuntos de peticiones.

Postman también admite otros protocolos además de HTTP, como GraphQL, gRPC, WebSocket y Socket.IO.

¿Qué es una API y qué tiene que ver con Postman?

Antes de comenzar conviene entender qué es una API.

Una API es una interfaz que permite que diferentes aplicaciones se comuniquen entre sí.

Por ejemplo, una tienda online puede tener una API que permita consultar productos. Una aplicación externa podría enviar una petición solicitando esos productos y recibir la información correspondiente.

La comunicación normalmente sigue un esquema parecido a este:

Postman
   │
   │ Petición
   ▼
API / Servidor
   │
   │ Respuesta
   ▼
Postman

Postman actúa como cliente y nos permite controlar y observar esa comunicación.

Primeros pasos con Postman

Para comenzar podemos instalar la aplicación de escritorio de Postman o utilizar su versión web. La documentación oficial recomienda la aplicación de escritorio para disfrutar de la experiencia completa de trabajo con peticiones.

Descargar y comenzar a utilizar Postman

Una vez instalado, podemos iniciar sesión con una cuenta de Postman. También existe un cliente ligero que permite crear y enviar peticiones sin iniciar sesión, aunque algunas funciones de organización y sincronización requieren una cuenta.

Crear nuestra primera petición

La forma más sencilla de aprender Postman es enviar una petición.

La documentación oficial utiliza Postman Echo como ejemplo para realizar la primera prueba.

Creamos una nueva petición y utilizamos:

GET https://postman-echo.com/get

Después pulsamos Send.

Postman enviará la petición al servidor y mostrará la respuesta en la parte inferior de la interfaz.

Esto nos permite comprobar el funcionamiento básico de una API sin necesidad de desarrollar ningún programa.

¿Qué significa GET?

En una petición HTTP utilizamos diferentes métodos dependiendo de la operación que queremos realizar.

Los más habituales son:

GET

Se utiliza normalmente para obtener información.

Por ejemplo:

GET /productos

Podría solicitar una lista de productos.

POST

Se utiliza habitualmente para enviar datos y crear recursos.

Por ejemplo:

POST /productos

Podría utilizarse para crear un producto nuevo.

PUT

Se utiliza para actualizar un recurso existente, normalmente enviando una representación completa del recurso.

PATCH

También sirve para actualizar información, pero normalmente se utiliza para modificar solamente determinados campos.

DELETE

Se utiliza para eliminar un recurso.

Estos métodos forman parte de los conceptos básicos que encontramos al trabajar con API.

La URL o endpoint

Cuando utilizamos una API necesitamos indicar dónde enviar la petición.

Ese punto de acceso recibe habitualmente el nombre de endpoint.

Por ejemplo:

https://ejemplo.com/api/productos

Dentro de una API pueden existir diferentes endpoints:

/api/productos
/api/usuarios
/api/pedidos
/api/categorias

Cada uno puede realizar diferentes operaciones.

Parámetros en Postman

Muchas API necesitan recibir información adicional mediante parámetros.

Por ejemplo:

GET https://ejemplo.com/api/productos?categoria=moviles

En este caso:

categoria=moviles

es un parámetro enviado al servidor.

Postman permite introducir estos parámetros desde la sección correspondiente de la petición sin necesidad de escribir manualmente toda la URL.

También podemos utilizar variables para no tener que repetir continuamente los mismos valores.

Headers o cabeceras

Las peticiones también pueden incluir headers, que proporcionan información adicional al servidor.

Por ejemplo:

Content-Type: application/json

Esta cabecera indica que el contenido enviado utiliza el formato JSON.

Otra cabecera habitual cuando una API requiere autenticación puede contener un token.

Postman permite configurar las cabeceras directamente desde la interfaz de creación de peticiones.

Enviar datos mediante POST

Imaginemos que tenemos una API que permite crear usuarios.

Podríamos realizar una petición:

POST https://ejemplo.com/api/usuarios

Y enviar un cuerpo JSON como:

{
  "nombre": "Antonio",
  "email": "usuario@ejemplo.com"
}

El servidor procesará esos datos y devolverá una respuesta.

En Postman podemos seleccionar Body, elegir el formato adecuado y escribir la información que queremos enviar.

¿Qué es una respuesta de API?

Cuando enviamos una petición, el servidor devuelve una respuesta.

Esta respuesta puede incluir diferentes elementos:

• Código de estado HTTP.
• Cabeceras.
• Datos.
• Mensajes de error.
• Información adicional.

Uno de los elementos más importantes es el código de estado.

Por ejemplo:

200 OK

indica normalmente que la petición se ha procesado correctamente.

Otros códigos habituales son:

201 Created
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error

Analizar estos códigos resulta fundamental cuando estamos comprobando una API.

Crear una colección en Postman

Cuando empezamos a tener varias peticiones, resulta mucho más práctico organizarlas.

Para ello existen las Collections o colecciones.

Una colección es un conjunto de peticiones que podemos guardar y organizar mediante carpetas. También puede contener configuraciones, pruebas, respuestas y otros elementos relacionados con una API.

Por ejemplo, podríamos crear una colección llamada:

API Tienda Online

Y dentro organizar:

API Tienda Online
│
├── Usuarios
│   ├── Obtener usuarios
│   ├── Crear usuario
│   └── Eliminar usuario
│
├── Productos
│   ├── Obtener productos
│   ├── Crear producto
│   └── Actualizar producto
│
└── Pedidos
    ├── Crear pedido
    └── Consultar pedido

Esto resulta especialmente útil cuando trabajamos con API grandes.

¿Qué son los entornos y las variables?

Otra función importante de Postman son los environments o entornos.

Imaginemos que tenemos una API de pruebas y otra API utilizada en producción:

https://pruebas.ejemplo.com
https://api.ejemplo.com

En lugar de modificar manualmente todas las peticiones, podemos utilizar una variable:

{{base_url}}/productos

Después podemos definir base_url según el entorno seleccionado.

Por ejemplo:

Entorno pruebas
base_url = https://pruebas.ejemplo.com

y:

Entorno producción
base_url = https://api.ejemplo.com

Postman permite utilizar variables en URL, parámetros, cuerpos, autenticación y scripts, facilitando el trabajo con diferentes entornos.

Probar una API con autenticación

Muchas API no permiten acceder libremente a todos sus recursos.

Es posible que necesitemos autenticarnos mediante:

• API Key.
• Bearer Token.
• Usuario y contraseña.
• OAuth 2.0.
• Otros sistemas de autenticación.

Postman permite configurar diferentes métodos de autorización desde la propia petición.

Por ejemplo, una API podría requerir:

Authorization: Bearer TU_TOKEN

El servidor utilizará ese token para determinar si tenemos permiso para realizar la operación solicitada.

Crear pruebas automáticas

Una de las características más útiles de Postman es la posibilidad de crear tests para comprobar automáticamente las respuestas de una API.

Por ejemplo, podemos comprobar que una petición devuelve el código HTTP 200:

pm.test("El código de respuesta es 200", function () {
    pm.response.to.have.status(200);
});

Después de enviar la petición, Postman ejecuta la prueba y muestra si se ha superado correctamente. La documentación oficial incluye este tipo de pruebas como parte del flujo inicial de aprendizaje.

También podemos comprobar que una respuesta contiene determinados datos.

Esto resulta especialmente útil cuando estamos desarrollando una API y queremos asegurarnos de que los cambios no rompen funcionalidades existentes.

Ejecutar varias peticiones

Cuando tenemos una colección con muchas peticiones, podemos ejecutarlas como un conjunto.

Esto permite utilizar una colección como un flujo de trabajo o conjunto de pruebas.

Postman ofrece el Collection Runner para ejecutar colecciones manualmente y también permite automatizar ejecuciones mediante diferentes mecanismos, incluidos Postman CLI y Newman.

Por ejemplo, podríamos crear un flujo como:

Crear usuario
      ↓
Iniciar sesión
      ↓
Obtener token
      ↓
Consultar productos
      ↓
Crear pedido
      ↓
Consultar pedido

De esta manera podemos comprobar un proceso completo en lugar de probar cada petición de manera aislada.

Postman también sirve para documentar API

Postman no se limita a enviar peticiones.

Las colecciones pueden utilizarse también para organizar información y generar documentación de las API. La plataforma permite añadir descripciones a colecciones, carpetas y peticiones para explicar cómo deben utilizarse.

Esto puede ser especialmente útil cuando varias personas trabajan con la misma API.

Un ejemplo sencillo para aprender Postman

Si estás empezando, puedes practicar con este pequeño ejercicio.

Primero realiza una petición:

GET https://postman-echo.com/get

Comprueba la respuesta.

Después crea una colección llamada:

Mi primera API

Guarda dentro la petición.

A continuación crea una prueba:

pm.test("La petición funciona", function () {
    pm.response.to.have.status(200);
});

Envía de nuevo la petición y comprueba el resultado del test.

Con este ejercicio ya habrás utilizado algunos de los conceptos fundamentales de Postman:

Petición
   ↓
Endpoint
   ↓
Servidor
   ↓
Respuesta
   ↓
Test
   ↓
Colección

¿Postman es solo para programadores?

Aunque Postman está especialmente orientado a desarrolladores y profesionales que trabajan con API, no es necesario ser un programador avanzado para comenzar a utilizarlo.

Una persona que está aprendiendo programación puede utilizarlo para entender cómo funcionan las API, mientras que un desarrollador puede emplearlo para comprobar endpoints antes de integrarlos en una aplicación.

También resulta útil para equipos de pruebas, profesionales de integración y personas encargadas de documentar o validar servicios.

Primeros pasos recomendados

Si nunca has utilizado Postman, no es necesario aprender todas sus funciones de golpe.

Un buen orden para empezar sería:

Instalar Postman
      ↓
Crear una petición GET
      ↓
Enviar la petición
      ↓
Analizar la respuesta
      ↓
Probar POST y enviar JSON
      ↓
Aprender headers y autenticación
      ↓
Crear una colección
      ↓
Utilizar variables
      ↓
Crear tests
      ↓
Ejecutar colecciones

Este recorrido permite aprender progresivamente sin tener que enfrentarse desde el principio a las funciones más avanzadas.

En resumen

Postman es una plataforma para trabajar con API que permite crear y enviar peticiones, analizar respuestas, organizar solicitudes en colecciones, utilizar variables y entornos, realizar pruebas y documentar servicios.

Para empezar solamente necesitamos entender algunos conceptos básicos: API, endpoint, petición, método HTTP y respuesta.

A partir de ahí podemos crear nuestra primera petición GET, comprobar el resultado y empezar a trabajar con métodos como POST, PUT, PATCH y DELETE.

Cuando tengamos varias peticiones, las colecciones nos ayudarán a organizarlas. Más adelante podemos utilizar variables, autenticación y pruebas automáticas para construir flujos de trabajo mucho más completos.

La mejor forma de aprender Postman es practicar con una API sencilla y avanzar poco a poco desde una primera petición hasta la creación de colecciones y tests.