En este tema, aprenderás cómo manejar errores y realizar depuración efectiva al trabajar con APIs en Postman. La habilidad para identificar y resolver problemas es crucial para asegurar que tus pruebas de API sean precisas y confiables.
Conceptos Clave
-
Errores Comunes en APIs:
- Errores del Cliente (4xx): Estos errores indican que la solicitud enviada al servidor es incorrecta o no puede ser procesada. Ejemplos incluyen:
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- Errores del Servidor (5xx): Estos errores indican que el servidor falló al completar una solicitud válida. Ejemplos incluyen:
- 500 Internal Server Error
- 503 Service Unavailable
- Errores del Cliente (4xx): Estos errores indican que la solicitud enviada al servidor es incorrecta o no puede ser procesada. Ejemplos incluyen:
-
Depuración en Postman:
- Consola de Postman: Una herramienta poderosa para ver los detalles de las solicitudes y respuestas, incluyendo encabezados, cuerpos y scripts de prueba.
- Mensajes de Error Detallados: Postman proporciona mensajes de error detallados que pueden ayudarte a identificar problemas específicos en tus solicitudes.
Uso de la Consola de Postman
La consola de Postman es una herramienta esencial para la depuración. Te permite ver la información detallada de cada solicitud y respuesta.
Cómo Abrir la Consola de Postman
- Haz clic en el icono de la consola en la parte inferior izquierda de la aplicación Postman.
- Alternativamente, puedes usar el atajo de teclado
Ctrl + Alt + C
(Windows) oCmd + Option + C
(Mac).
Ejemplo de Uso de la Consola
// Ejemplo de script de prueba en Postman pm.test("El estado de la respuesta es 200", function () { pm.response.to.have.status(200); }); // Imprimir el cuerpo de la respuesta en la consola console.log(pm.response.text());
- Explicación: Este script verifica que el estado de la respuesta sea 200 y luego imprime el cuerpo de la respuesta en la consola para una inspección más detallada.
Estrategias de Manejo de Errores
-
Validación de Respuestas:
- Asegúrate de que las respuestas de la API contengan los datos esperados y que los códigos de estado sean correctos.
- Usa scripts de prueba para validar automáticamente las respuestas.
-
Manejo de Excepciones:
- Implementa lógica en tus scripts para manejar excepciones y errores inesperados.
- Usa bloques
try-catch
en scripts de pre-solicitud o de prueba para capturar y manejar errores.
Ejemplo de Manejo de Excepciones
try { let jsonData = pm.response.json(); pm.test("El nombre del usuario es correcto", function () { pm.expect(jsonData.name).to.eql("John Doe"); }); } catch (e) { console.error("Error al analizar la respuesta JSON: ", e); }
- Explicación: Este script intenta analizar la respuesta JSON y verifica que el nombre del usuario sea "John Doe". Si ocurre un error durante el análisis, se captura y se imprime en la consola.
Ejercicios Prácticos
Ejercicio 1: Identificación de Errores
- Envía una solicitud a una API que sabes que devolverá un error 404.
- Usa la consola de Postman para identificar el error y anota los detalles.
Ejercicio 2: Manejo de Errores en Scripts
- Crea una solicitud que devuelva un error 500.
- Escribe un script de prueba que maneje este error y registre un mensaje personalizado en la consola.
Soluciones
Ejercicio 1:
- Envía una solicitud a
https://jsonplaceholder.typicode.com/invalidendpoint
. - Observa el error 404 en la consola y revisa los encabezados y el cuerpo de la respuesta.
Ejercicio 2:
pm.test("Manejo de error 500", function () { if (pm.response.code === 500) { console.error("Error del servidor: 500 Internal Server Error"); } else { pm.expect(pm.response.code).to.be.below(500); } });
Conclusión
El manejo de errores y la depuración son habilidades esenciales para cualquier probador de API. Al utilizar la consola de Postman y escribir scripts de prueba efectivos, puedes identificar y resolver problemas rápidamente, asegurando que tus pruebas sean robustas y confiables. En el siguiente tema, exploraremos cómo realizar pruebas de rendimiento con Postman para evaluar la eficiencia de tus APIs.
Curso de Postman y Pruebas de API
Módulo 1: Introducción a las APIs y Postman
Módulo 2: Pruebas Básicas de API con Postman
- Creando Tu Primera Solicitud
- Entendiendo Solicitud y Respuesta
- Usando Colecciones de Postman
- Variables de Entorno en Postman
Módulo 3: Técnicas Intermedias de Pruebas de API
- Encadenando Solicitudes
- Usando Scripts de Postman
- Pruebas Basadas en Datos con Postman
- Pruebas de APIs RESTful
Módulo 4: Funciones Avanzadas de Postman
- Automatizando Pruebas con Newman
- Integración Continua con Postman
- Servidores Simulados en Postman
- Técnicas Avanzadas de Scripting
Módulo 5: Mejores Prácticas de Pruebas de API
- Diseñando Casos de Prueba Efectivos
- Manejo de Autenticación
- Manejo de Errores y Depuración
- Pruebas de Rendimiento con Postman