Ejemplos
Comprueba más que el status
Criterios de éxito más allá del status: una condición sobre el body, un regex sobre un header y un JSONPath sobre el body, y uno que falla a propósito.
Qué prueba: una búsqueda de productos responde 200, encuentra resultados, devuelve JSON y tiene al menos un producto con precio mayor que 0. Un segundo workflow falla a propósito.
Descargar el contrato Descargar el ArazzoÁbrelo en Luvin
Sección titulada «Ábrelo en Luvin»- Descarga los archivos con los botones de arriba.
- En Luvin, crea una colección con Nueva colección en el inicio del workspace, o abre una que ya tengas.
- En Acciones rápidas, haz clic en Importar Arazzo o contratos y elige juntos los archivos
.yamldescargados. - En la barra lateral, abre el workflow Search phones.
- En la barra de ejecución, elige API real.
- Pulsa Ejecutar. Los resultados se abren abajo.
Las líneas clave
Sección titulada «Las líneas clave»arazzo: 1.0.1info: title: Success criteria beyond the status version: 1.0.0sourceDescriptions: - name: dummyjson url: ./dummyjson.openapi.yaml type: openapiworkflows: - workflowId: searchPhones summary: Search products and check the status, a number, a header and a price inputs: type: object properties: q: { type: string, example: phone } steps: - stepId: search operationId: searchProducts parameters: - name: q in: query value: $inputs.q - name: limit in: query value: 3 - name: select in: query value: title,price successCriteria: - condition: $statusCode == 200 - condition: $response.body#/total > 0 - context: $response.header.Content-Type condition: ^application/json type: regex - context: $response.body condition: $.products[?(@.price > 0)] type: jsonpath outputs: total: $response.body#/total firstTitle: $response.body#/products/0/title outputs: total: $steps.search.outputs.total
- workflowId: impossiblePrice summary: Fails on purpose - no phone costs more than 100000 steps: - stepId: search operationId: searchProducts parameters: - name: q in: query value: phone - name: limit in: query value: 3 - name: select in: query value: title,price successCriteria: - condition: $statusCode == 200 - context: $response.body condition: $.products[?(@.price > 100000)] type: jsonpath| Línea | Qué hace |
|---|---|
| 30 | Una condición simple sobre el status. Simple es el tipo por defecto. |
| 31 | Una condición simple sobre un valor del body: la búsqueda encontró al menos un producto. |
| 32-34 | Un criterio regex. Su context es el header Content-Type, que debe empezar con application/json. |
| 35-37 | Un criterio jsonpath sobre todo el body. Pasa cuando la ruta encuentra al menos una coincidencia: aquí, un producto con precio mayor que 0. |
| 44-60 | El segundo workflow, impossiblePrice, pide un precio mayor que 100000. Ningún teléfono cuesta tanto, así que falla a propósito. |
Qué obtienes
Sección titulada «Qué obtienes»Los dos workflows llaman a GET /products/search?q=phone&limit=3&select=title,price.
| Workflow | Paso | Status HTTP | Resultado |
|---|---|---|---|
searchPhones |
search |
200 | Los cuatro criterios se cumplen. Output total = 23. Pasó. |
impossiblePrice |
search |
200 | La API respondió 200, pero el criterio JSONPath no se cumple. No pasó. |
La razón que Luvin muestra en impossiblePrice es:
JSONPath no encontró coincidencias en $response.body.Un status 200 no basta: el paso falla porque un criterio falla. El workflow se detiene ahí y sus outputs quedan vacíos. En el expect.json de la receta este workflow está marcado como failed, porque fallar es lo que debe hacer.
Un criterio de tipo regex también se explica solo. Con condition: ^text/html sobre el mismo header, la razón dice:
$response.header.Content-Type = "application/json; charset=utf-8" no cumple /^text/html/Pruébalo
Sección titulada «Pruébalo»- Cambia
qporlaptopen la pestaña Inputs y ejecutasearchPhonesotra vez. El total pasa a5y los criterios se siguen cumpliendo. - En
impossiblePrice, cambia100000por100. El criterio ahora encuentra los productos que cuestan más de 100 y el workflow pasa.