Tutoriales
Averigua por qué falló un caso
Lee el veredicto y su motivo, abre el paso que falló, revisa el request en Dev Tools, repítelo en una terminal con cURL y corrige el input.
Un caso terminó como No pasó y necesitas saber por qué: ¿tu workflow, tus datos o la API? Vas a provocar una falla a propósito en el ejemplo de la Pokédex y la seguirás desde el veredicto hasta el request exacto. Necesitas unos 20 minutos, Luvin abierto con el ejemplo de la Pokédex, conexión a internet y, para el paso 5, una terminal.
1. Provoca una falla
Sección titulada «1. Provoca una falla»- Abre Pokemon card y haz clic en la pestaña Inputs.
- Escribe
missingnoenpokemon. Ese Pokémon no existe. - Haz clic en la pestaña Casos y en Ninguno para desmarcar todos los casos. Marca Camino feliz.
- En la barra de ejecución, elige API real y haz clic en Ejecutar.
Los resultados se abren abajo y el caso termina como No pasó.
2. Lee el veredicto y el motivo
Sección titulada «2. Lee el veredicto y el motivo»
- Mira el encabezado de los resultados. El contador ✕ dice 1.
- Haz clic en el caso de la lista de la izquierda. El detalle muestra su veredicto, No pasó, y estas filas:
| Fila | Qué dice aquí |
|---|---|
| Esperado | Todos los pasos cumplen sus criterios. |
| Resultado | El motivo en palabras simples. Empieza con Falló en el paso “getPokemon” y dice La API respondió 404 Not Found. |
Ya sabes dónde se rompió (el primer paso) y qué pasó (la API no encontró el Pokémon). Mira Lee los resultados.
3. Abre el paso que falló
Sección titulada «3. Abre el paso que falló»Bajo el detalle, cada paso es una tarjeta. La que falló ya está abierta.
- Lee su encabezado: el estado Falló, el método y la ruta, y el status HTTP
404. - Lee la nota bajo el encabezado. Nombra el tipo de problema, Error devuelto por la API, y la acción que se activó, Fin del workflow (acción “pokemonNotFound”).
- Haz clic en la pestaña Criterios. Cada criterio de éxito dice Se cumple o No se cumple. El criterio del status no se cumple.
- Haz clic en Petición para ver la URL, los headers y el body que se enviaron. La ruta termina en
/pokemon/missingno. - Haz clic en Respuesta para ver qué contestó la API.
Los pasos siguientes dicen No ejecutado, porque el workflow se detuvo. Mira Lee el resultado de un paso.
Cuando la etiqueta es “Criterio no cumplido”
Sección titulada «Cuando la etiqueta es “Criterio no cumplido”»Aquí la API respondió con un error. Cuando la API responde 200 pero un valor es incorrecto, la etiqueta es Criterio no cumplido y la nota compara dos valores. Por ejemplo, en una API de tienda:
statusEsperado "ACTIVE"Recibido "INACTIVE"Pulsa Ver en la respuesta. Se abre la pestaña Respuesta con ese campo resaltado en el body. Compara el campo con lo que esperabas: puede que la API haya cambiado, o que tus datos no sean lo que pensabas.
4. Mira el request real en Dev Tools
Sección titulada «4. Mira el request real en Dev Tools»Dev Tools lista cada request que envió Luvin, con los secretos tapados.
- Haz clic en Dev Tools en la barra de abajo de la ventana y abre la pestaña Network.
- Busca la fila con el status
404en rojo. Las filas que fallaron aparecen resaltadas. Escribemissingnoen Filtrar por URL, paso o status… para encontrarla más rápido. - Haz clic en la fila. Se abre un panel con el resumen: Status, Tiempo, Tamaño, Paso y Caso.
- Haz clic en Petición y luego en Respuesta para leer los headers y el body de cada una.

Si no ves Dev Tools, estás en la interfaz Simple. Cambia a la completa en Preferencias. Mira Recorrido por la interfaz.
5. Repítelo en una terminal
Sección titulada «5. Repítelo en una terminal»Si el mismo request falla fuera de Luvin, el problema no está en el workflow.
- En el detalle del request, haz clic en Copiar como cURL. El botón muestra ✓ Copiado.
- Pégalo en una terminal y pulsa Enter. Agrega
-idespués decurlpara ver la línea de status.
curl -i 'https://pokeapi.co/api/v2/pokemon/missingno'La terminal también responde 404. Entonces el workflow está bien y el dato es incorrecto. Los secretos del comando aparecen como <secret>: reemplázalos por los valores reales. Mira Network.
6. Prueba la operación sola
Sección titulada «6. Prueba la operación sola»Puedes llamar a una operación sin el resto del workflow.
- En Diseño, haz clic en el paso
getPokemon. - Haz clic en ▶ Probar sola. Se abre una pestaña con la operación.
- Elige API real, revisa el ambiente y haz clic en Enviar.
Aparecen el status y el body. Cambia el parámetro de la ruta a pikachu y envía otra vez: obtienes 200. Ahora sabes que la operación funciona y que solo el valor estaba mal. Mira Probar una operación.
7. Cuando la API no responde
Sección titulada «7. Cuando la API no responde»No toda falla es una respuesta. Si el paso tiene la etiqueta Red o CORS y no hay status, la API no respondió. Un panel con el título No se pudo conectar con la API aparece sobre los resultados, con la cantidad de casos afectados y los servidores que no respondieron.
- Haz clic en Abrir https://… ↗ para probar la dirección en tu navegador. Si no carga, el problema es el servidor o la dirección.
- Haz clic en Revisar ambiente y comprueba la URL base.
- En la versión de navegador, si la dirección carga en otra pestaña, la causa probable es CORS: haz clic en Copiar headers y envíalos a quien administra la API. La app de escritorio no tiene la restricción de CORS.
- Haz clic en Probar en simulación para seguir trabajando mientras se arregla.
Mira Ayuda de conexión.
8. Corrige el input y ejecuta otra vez
Sección titulada «8. Corrige el input y ejecuta otra vez»- Haz clic en la pestaña Inputs y escribe
pikachuenpokemon. - Haz clic en la pestaña Casos y luego en Ejecutar.
Si la ejecución se pausa con Ejecución en pausa, haz clic en Continuar con este elemento cada vez. El caso termina como Pasó. Mira Elegir un elemento de una lista.
Qué aprendiste
Sección titulada «Qué aprendiste»- La fila Resultado dice en palabras simples dónde se rompió el caso y por qué.
- La etiqueta de un paso que falló dice el tipo de problema: la API devolvió un error, no se cumplió un criterio, no hubo respuesta, etcétera.
- Ver en la respuesta resalta el campo que difiere.
- Network de Dev Tools muestra el request exacto, y Copiar como cURL lo repite en una terminal.
- ▶ Probar sola prueba una operación sin el resto del workflow.
- El panel de conexión ayuda cuando la API no responde.