¿Cómo crear un escenario de prueba en Apidog?

Crear un escenario de prueba

Al abrir Apidog, vaya al módulo “Tests” y, a continuación, haga clic en el + junto a la barra de búsqueda para crear un nuevo escenario de prueba. Seleccione el directorio adecuado para este y establezca la prioridad para completar la creación.

Añadir pasos de prueba

Una vez que haya configurado su escenario de prueba en Apidog, puede comenzar a rellenarlo con peticiones. Hay varias formas de añadir peticiones, cada una adaptada a distintas necesidades y niveles de flexibilidad:

Peticiones vinculadas a la especificación de la API—Estas peticiones podrían actualizarse a medida que cambie la especificación de la API:

a. Importar desde la especificación del endpoint: Este método consiste en importar peticiones directamente desde la definición estructurada dentro de la especificación de la API. Garantiza que sus pruebas estén alineadas con la interfaz documentada de la API, aunque es posible que deba ajustar manualmente los parámetros de la petición para cumplir condiciones de prueba específicas.

b. Importar desde el caso de endpoint: Utilice esta opción para extraer peticiones de casos de endpoint predeterminados que ya contienen parámetros configurados. Esto resulta especialmente útil para pruebas estandarizadas que simulan el uso real de la API, lo que permite mantener la coherencia entre ejecuciones de prueba.

Peticiones independientes no asociadas con la especificación de la API—Estas peticiones no se actualizan en respuesta a cambios en la especificación de la API. Permiten una mayor personalización:

a. Añadir petición personalizada: Cree peticiones desde cero para adaptar los escenarios de prueba a requisitos específicos. Este enfoque ofrece la máxima flexibilidad para explorar más allá de los límites de la especificación de la API existente.

b. Añadir desde cURL: Aprovechar cURL le permite importar o modelar peticiones personalizadas de forma eficiente. Es una forma práctica de crear rápidamente peticiones que imiten interacciones de API complejas o únicas sin estar limitado por la especificación de la API.

Referenciar otros escenarios de prueba:

a. Incluir peticiones de otros escenarios de prueba: Este método le permite importar peticiones específicas desde distintos escenarios de prueba ya definidos en su proyecto.

b. Referenciar otro escenario de prueba: Para pruebas completas, es posible que necesite emplear la totalidad de otro escenario de prueba. Esta capacidad garantiza que pueda integrar todas las pruebas y configuraciones relacionadas, evitando la necesidad de duplicar esfuerzos de configuración y fomentando estrategias de prueba unificadas.

Importar desde la especificación del endpoint

Puede importar especificaciones de endpoint desde el proyecto actual como pasos en el escenario de prueba. Hay dos modos al importar endpoints: "Manual" y "Automated". Para obtener instrucciones más detalladas, consulte Sync Data from APIs/API Cases.

Manual

En el modo "Manual", las modificaciones realizadas en la documentación del endpoint dentro del proyecto no tienen un impacto inmediato en los endpoints de los pasos de prueba. La sincronización de los datos de prueba solo se produce cuando los testers activan el botón "Manual". Es importante señalar que las alteraciones realizadas en los datos del paso de prueba no actualizarán la documentación del endpoint, incluso al hacer clic en "Manual Sync". En su lugar, al hacer clic en este botón, los escenarios de prueba pueden recuperar información de la documentación del endpoint con fines de sincronización.

Automated

En el modo "Automated", cualquier cambio en la documentación del endpoint dentro del proyecto se actualizará de forma síncrona en los pasos de prueba.

Si necesita probar endpoints de otros proyectos en un escenario de prueba, consulte Import Endpoints/Cases from Other Projects to Test Steps.

Importar desde un caso de endpoint

Puede elegir importar casos de endpoint desde el proyecto actual u otros proyectos. Hay dos modos al importar casos de endpoint: "Copy" y "Reference".

Copy

Al importar un caso de endpoint como "Copy", los parámetros del caso de endpoint también se copiarán en los pasos de prueba. Serán independientes entre sí, y los cambios en cada uno no afectarán a los demás. Se puede seleccionar la sincronización manual.

Reference

Al importar un caso de endpoint como "Reference", se utilizará directamente el caso de endpoint del proyecto original para la petición.

Añadir petición personalizada

En un proceso de trabajo, es posible que necesite llamar a un endpoint fuera del proyecto, como un endpoint de pago de terceros.

Puede añadir una petición de API personalizada en los pasos de prueba. La petición personalizada puede ser cualquier petición HTTP, incluidas las comunes GET, POST, PUT, DELETE, etc.

Añadir desde cURL

En procesos de trabajo reales, muchas peticiones de endpoint se presentan en forma de líneas de comando cURL. Tiene la opción de importar peticiones cURL en los pasos de prueba con un solo clic.

Incluir pasos de otros escenarios de prueba

Puede clonar los pasos de prueba o las condiciones de control del proceso importándolos desde otros escenarios de prueba dentro del mismo proyecto.

Referenciar otros escenarios de prueba

Puede referenciar otros escenarios de prueba como un paso de prueba. Hay dos casos de uso:

Si su proceso de negocio tiene algunos pasos de prueba de API comunes y reutilizables, puede compilar estos pasos en un pequeño escenario de prueba y luego referenciarlo directamente en otros escenarios de prueba más amplios.

Si necesita realizar la regresión del proceso principal de todo el producto, puede hacer referencia a los distintos subescenarios de prueba en el escenario de prueba para ensamblarlos y completar el trabajo de regresión de prueba de todos los procesos principales con un solo clic.

Para evitar bucles infinitos y situaciones en las que el escenario de prueba no pueda dejar de ejecutarse normalmente, la función de referenciar otros escenarios de prueba no puede referenciar el escenario de prueba original en sí.

Orquestar el escenario de prueba

Al hacer clic en cualquier paso de prueba, entrará en el modo de orquestación. En este modo, dispone de una página de operación más amplia para completar mejor y de forma más eficiente el contenido detallado de cada paso de prueba. El lado izquierdo de la página muestra el flujo general del escenario de prueba, y el lado derecho muestra los detalles del paso de prueba seleccionado. Las peticiones de endpoint y los componentes de control del proceso de prueba tendrán distintos paneles de visualización.

Puede ajustar el orden de los pasos arrastrando el ≡ delante del paso.

Puede utilizar las teclas "⬆️" y "⬇️" para cambiar rápidamente entre los pasos de prueba seleccionados en este modo.

En el modo de orquestación, puede editar varios pasos y luego hacer clic en el botón "Save All" en la esquina superior izquierda para guardar todos los cambios.

Si algún paso tiene cambios sin guardar, el paso se marcará con un punto en la barra de lista de la izquierda. Recuerde guardar siempre los cambios que haya realizado.

¿Cómo crear un escenario de prueba en Apidog?

Crear un escenario de prueba#

Añadir pasos de prueba#

Importar desde la especificación del endpoint#

Importar desde un caso de endpoint#

Añadir petición personalizada#

Añadir desde cURL#

Incluir pasos de otros escenarios de prueba#

Referenciar otros escenarios de prueba#

Orquestar el escenario de prueba#

Crear un escenario de prueba

Añadir pasos de prueba

Importar desde la especificación del endpoint

Importar desde un caso de endpoint

Añadir petición personalizada

Añadir desde cURL

Incluir pasos de otros escenarios de prueba

Referenciar otros escenarios de prueba

Orquestar el escenario de prueba