A partir de la versión 2.7.29 de Apidog, ahora puede añadir casos de prueba directamente en la página de detalles del endpoint.
Cada caso de prueba representa un conjunto de parámetros de petición para el endpoint. Los usuarios pueden organizar y gestionar todos los casos de prueba de forma sistemática y, luego, ejecutarlos con un solo clic para completar la prueba del endpoint actual.
Casos de prueba frente a casos de depuración
Casos de prueba
Propósito: Verificar si el endpoint se comporta según lo esperado en distintos escenarios de petición, con énfasis en la exhaustividad.
Cubren una amplia variedad de escenarios: positivos, negativos, de límite y de seguridad.
Por lo general, se modifican o ejecutan con menor frecuencia.
Casos de depuración
Propósito: Verificar rápidamente las respuestas del endpoint durante el desarrollo o la solución de problemas, con énfasis en la velocidad.
Generalmente se limitan a escenarios básicos, como éxito y fallo.
Al añadir un caso de prueba, puede elegir Importar desde casos de depuración para copiar o mover los casos de depuración existentes a casos de prueba.
Copiar: Use esta opción cuando todavía necesite el caso de depuración para una validación rápida, pero también desee tenerlo como caso de prueba.
Mover: Use esta opción cuando el caso de depuración ya no se utilice con frecuencia para depuración y se haya escrito principalmente para probar excepciones. Esto lo convierte directamente en un caso de prueba, lo que agiliza la migración si los casos de prueba se crearon originalmente como casos de depuración.
Un caso de prueba contiene la siguiente información:
Grupo: Organizado por propósito de prueba (positivo, negativo, límite, etc.).
Nombre del caso: El nombre del caso de prueba.
Parámetros de petición: Parámetros Path, Query, Header y Body form-data.
Cuerpo de la petición: Compatible con RAW, JSON, XML, etc.
Procesadores previos/posteriores
Validación de respuesta: Active/desactive la validación y especifique los componentes de la respuesta que se deben validar.
[!NOTE] Dado que los casos de prueba se actualizan con menor frecuencia, deben sincronizarse manualmente con los cambios del endpoint. Por ejemplo, si se añade un nuevo campo al endpoint, deberá hacer clic en Actualizar en el caso de prueba para actualizarlo.
Cualquier edición de los detalles del caso de prueba debe guardarse haciendo clic en Guardar. Si hay cambios sin guardar, el sistema se lo indicará.
En la pestaña Casos de prueba, puede gestionar todos los casos de prueba creados. Use las funciones de búsqueda y filtro en la esquina superior izquierda para encontrar fácilmente los casos de prueba que necesita. También puede usar la pestaña de grupo para ver rápidamente los casos de prueba por grupo. Para operaciones en casos de prueba específicos:
Caso de prueba individual: Puede abrir una nueva pestaña para ver, modificar y ejecutar un caso de prueba. Las operaciones básicas incluyen copiar, mover el caso de prueba a otros grupos, copiar el cURL del caso de prueba y eliminar el caso de prueba.
Múltiples casos de prueba: Cuando seleccione varios casos de prueba en la lista, aparecerán botones de acción en la esquina superior derecha, lo que le permitirá agrupar por lotes, eliminar y sincronizar con actualizaciones del endpoint.
Al ver un caso de prueba, haga clic en el botón Ejecutar para enviar una petición con sus parámetros. A continuación, se mostrará la respuesta real.
También puede usar Ejecutar todo o seleccionar varios casos de prueba de la lista y ejecutarlos juntos. La interfaz mostrará qué casos se están ejecutando actualmente y cuáles tienen resultados.
Después de una ejecución por lotes, puede abrir un caso de prueba para ver directamente sus resultados de ejecución.
Después de ejecutar pruebas de forma masiva, puede consultar todos los informes históricos en Informes de prueba, en la parte superior derecha.
Haga clic en un informe para ver resultados detallados, lo que ayuda con el seguimiento y el análisis de problemas.
Una descripción general de cómo funcionan los casos de prueba:
Prácticas recomendadas para pruebas de un solo endpoint#
Las pruebas de un solo endpoint suelen implicar dos roles: desarrolladores backend e ingenieros de QA.
Desarrolladores backend: Escriben y depuran el código del endpoint.
Ingenieros de QA: Realizan pruebas exhaustivas de API e identifican problemas.
Ahora que Apidog admite casos de prueba para endpoints, el flujo de trabajo puede ser más eficiente:
Los ingenieros de QA pueden escribir y gestionar directamente casos de prueba unitarios dentro de la documentación del endpoint.
Los desarrolladores pueden usar casos de prueba existentes para ejecutar pruebas, ver resultados y corregir problemas por sí mismos, sin esperar comentarios de los ingenieros de QA ni comunicaciones prolongadas.
Flujo de trabajo recomendado:
Este flujo de trabajo puede mejorar la eficiencia colaborativa:
1.
Los casos de prueba pueden escribirse justo después de que se finalice la documentación del endpoint, y estar visibles para todos los miembros del equipo en Apidog.
2.
Los desarrolladores pueden probar los endpoints por sí mismos después de la depuración, sin necesidad de esperar a los ingenieros de QA.
3.
Los desarrolladores pueden corregir problemas directamente según los resultados de las pruebas, sin tickets adicionales ni traspasos requeridos.
4.
Los resultados de prueba claros hacen que las explicaciones de los problemas sean sencillas, evitando malentendidos.
