La mayoría de las aplicaciones de hoy hablan con servidores mediante API. Si la API falla, la aplicación falla, aunque la pantalla se vea bien. Probar las API directamente encuentra los problemas pronto y es mucho más rápido que hacer clic en un navegador.

Postman te da una pantalla amigable para hacer este trabajo. No necesitas ser desarrollador para empezar.

Por qué importan las pruebas de API

• Velocidad: una prueba tarda milisegundos, no segundos.
• Estabilidad: no hay interfaz que cambie, así que las pruebas se rompen menos.
• Respuesta temprana: puedes probar antes de que el front-end esté listo.
• Mejor cobertura: puedes probar entradas incorrectas y casos límite difíciles de alcanzar desde la pantalla.

Fundamentos de API en dos minutos

Una API permite que un programa pida datos o acciones a otro. En una API REST, envías una solicitud con un método, una URL, cabeceras opcionales y datos opcionales. Recibes un código de estado y un cuerpo, normalmente en JSON.

¿Quieres saber cómo se diseñan las buenas API? Consulta nuestras buenas prácticas de API REST.

Envía tu primera solicitud

1. Instala Postman, o usa la versión web, y crea una cuenta gratuita.
2. Haz clic en New y elige HTTP request.
3. Pon el método en GET e introduce la URL de una API de pruebas pública, como https://jsonplaceholder.typicode.com/users/1.
4. Haz clic en Send.

Verás el código de estado, el tiempo empleado y el cuerpo JSON debajo. Esa es una llamada a una API que funciona. Ahora aprendamos a leerla.

Lee los códigos de estado

• 2xx significa éxito, como 200 OK o 201 Created.
• 3xx significa una redirección.
• 4xx significa que el cliente cometió un error, como 400, 401, 403 o 404.
• 5xx significa que el servidor falló, como 500 o 503.

Una buena prueba comprueba tanto los caminos felices como los de error. Por ejemplo, envía un correo vacío a un endpoint de registro y espera un 400 o 422, no un 200.

Añade autenticación

La mayoría de las API reales necesitan que demuestres quién eres. En la pestaña Authorization, Postman admite los tipos habituales:

• Clave de API: un secreto enviado en una cabecera o en la consulta.
• Token Bearer: un token, a menudo obtenido de una llamada de login, enviado en la cabecera Authorization.
• Autenticación básica: usuario y contraseña.
• OAuth 2.0: un flujo de tokens usado por muchos servicios grandes.

Escribe scripts de prueba

Aquí es donde Postman se convierte en una herramienta de pruebas de verdad. En la pestaña Scripts (Tests) escribes breves comprobaciones en JavaScript que se ejecutan después de cada respuesta.

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

pm.test("La respuesta es lo bastante rápida", function () {
  pm.expect(pm.response.responseTime).to.be.below(800);
});

pm.test("El usuario tiene los campos esperados", function () {
  const user = pm.response.json();
  pm.expect(user).to.have.property("id", 1);
  pm.expect(user.email).to.include("@");
});

Vuelve a ejecutar la solicitud. La pestaña Test Results muestra si cada comprobación pasa o falla. Si sabes un poco de JavaScript, estos scripts te resultarán naturales. Si no, nuestro tutorial de JavaScript para principiantes cubre lo que necesitas.

Usa variables y entornos

Las URL escritas a mano hacen que las pruebas sean difíciles de reutilizar. En su lugar, crea un entorno para cada etapa, como Dev, Staging y Prod. Añade una variable llamada baseUrl y úsala así:

{{baseUrl}}/users/1

Ahora pasar de staging a producción es un solo clic. También puedes guardar valores de una respuesta y usarlos en la siguiente solicitud, como un token de login:

const token = pm.response.json().token;
pm.environment.set("authToken", token);

Organiza con colecciones

Una colección es una carpeta de solicitudes relacionadas. Agrúpalas por funcionalidad, como Usuarios, Pedidos y Pagos. Añade las comprobaciones comunes a nivel de colección para que todas las solicitudes las reciban. También puedes ejecutar una colección entera en orden con el Collection Runner.

Para probar muchas entradas, carga un archivo CSV o JSON en el runner. Postman repite las solicitudes con cada fila de datos. Eso es una prueba dirigida por datos sencilla.

Ejecuta las pruebas de Postman en CI

Puedes ejecutar colecciones desde la línea de comandos usando Newman, el ejecutor de Postman. Exporta tu colección y tu entorno y luego ejecuta:

npm install -g newman
newman run my-collection.json -e staging.json --reporters cli,junit

Añade este comando a tu pipeline para que las pruebas de API se ejecuten en cada cambio. Nuestra guía de GitHub Actions CI/CD muestra dónde encaja este paso.

Buenas prácticas para las pruebas de API

• Prueba el camino feliz y luego las entradas incorrectas, los campos que faltan y los permisos erróneos.
• Comprueba el cuerpo de la respuesta, no solo el código de estado.
• Mantén cada solicitud independiente siempre que puedas.
• Pon nombres claros a las solicitudes, como “Crear pedido – falta la dirección”.
• Limpia los datos que crees.
• Combina las pruebas de API con unas pocas comprobaciones de interfaz. Consulta las buenas prácticas de pruebas end-to-end.

Preguntas frecuentes

Sigue aprendiendo