¿Cómo convierto las llamadas a la API de mi aplicación en pruebas de API?
Grábalas mientras usas la aplicación, revisa la lista y genera una prueba a partir de las llamadas que conserves. Nexus Recorder en Nexus StudioQA, de Verdict System LLC, graba las llamadas que hace una página como pruebas REST o GraphQL, omite las cabeceras de autenticación y cookies y convierte los campos que parecen contener secretos en variables de entorno. Todo se ejecuta en tu propio equipo.
Última actualización:
Por el equipo de Nexus StudioQA, Verdict System LLC.
¿Cómo funciona la grabación?
- En Nexus Recorder, graba las llamadas que hace la página mientras recorres un flujo, como un inicio de sesión y un proceso de compra.
- Antes de generar ninguna prueba, la sección Revisión muestra cada llamada con su método, ruta, estado, categoría y el motivo de su inclusión o exclusión.
- Las llamadas de negocio, autenticación, lectura y cambio de estado se incluyen inicialmente en el conjunto de pruebas. Las balizas de telemetría, los hosts de terceros, los recursos y las solicitudes preliminares se excluyen inicialmente, y puedes marcar cualquiera de ellos para volver a incluirlo.
- Los flujos encadenan un valor de una respuesta con una solicitud posterior, como el token que devuelve un inicio de sesión.
¿Qué puedo generar a partir de una grabación?
- Generar prueba crea el conjunto de pruebas de API.
- Generar OpenAPI crea un borrador OpenAPI 3.1 con tipos y códigos de estado, sin ninguno de los valores grabados.
- Prueba de carga abre las mismas llamadas como un plan de carga.
¿Qué se excluye del archivo de prueba?
| Qué capturó la grabación | Qué recibe el archivo de prueba |
|---|---|
| Cabeceras de autenticación y cookies | Se omiten |
| Campos con nombres que sugieren secretos | Una variable de entorno, incluida en la sección Ocultaciones |
| JWT, claves de proveedores y números de tarjeta en cualquier campo | Se ocultan según su valor, no solo por el nombre del campo |
| Telemetría, hosts de terceros, recursos y solicitudes preliminares | Excluidos de forma predeterminada |
Cuando se ejecuta la prueba, su token de autenticación se envía solo al origen de API_BASE_URL, nunca a otro host que apareciera en la grabación.
¿Cómo se evalúan las pruebas de API?
Se ejecutan desde Patrol como cualquier otra prueba, y cada punto de conexión genera su propia carpeta de evidencias. Las pruebas de API no tienen un entorno aislado: se ejecutan de verdad desde la primera pulsación. Reciben sus propios veredictos de API: API_SECURE cuando se cumplen todas las aserciones y la estructura de la respuesta coincide con la última grabada, API_FLAKY cuando un reintento pasa y API_DRIFTED cuando la prueba pasa pero la estructura cambia, con indicación de cada campo añadido, eliminado o cuyo tipo haya cambiado. Cambios en el esquema de la API muestra un cambio en una ejecución real.
¿Cuáles son los límites?
- Una grabación solo contiene las llamadas que hizo la página mientras grababas. Un punto de conexión al que el flujo nunca accedió no aparece en ella.
- La grabación genera pruebas REST y GraphQL. Las pruebas SOAP se crean a mano, como XML enviado como texto y verificado con reglas de texto.
- Las pruebas de API usan el formato propio de Studio, por lo que trasladarlas a otro ejecutor implica reescribirlas. Las pruebas de navegador que genera Recorder siguen siendo Playwright o Selenium estándar.
- Revisa la prueba generada antes de confiar en ella: la grabación sabe lo que hizo la aplicación, no lo que debería hacer.
¿Dónde puedo verlo?
La visita guiada de Studio muestra Nexus Recorder, y Cambios en el esquema de la API explica los veredictos de API con un ejemplo ejecutable. La prueba gratuita ejecuta el mismo motor en tu propia aplicación.