Tutoriales
Comprueba que tu API rechaza datos malos
Ejecuta los casos de rechazo que genera Luvin, elige qué status debe devolver cada uno, agrega un caso con tus propios datos y comparte los resultados como reporte HTML.
Una buena API acepta lo válido y rechaza lo que no lo es. Vas a ejecutar los casos que comprueban la segunda mitad en el ejemplo de la Pokédex, decidirás qué significa “rechazado” para tu API, agregarás un caso propio y exportarás un reporte. Necesitas unos 20 minutos y conexión a internet. No hacen falta credenciales.
1. Conoce los casos de rechazo
Sección titulada «1. Conoce los casos de rechazo»Luvin genera estos casos a partir del contrato y del workflow. Están en la pestaña Casos, en los grupos Validación de datos y Seguridad.
| Caso | Qué envía | Cuándo existe |
|---|---|---|
| Sin el input obligatorio “…” | Deja fuera un input obligatorio. | Un input obligatorio que no va en la ruta de la URL. |
| “…” con … | Un valor incorrecto: fuera de las opciones permitidas, un texto en lugar de un número, o un valor que no cumple el patrón. | Un input con opciones permitidas, de tipo número o sí/no, o con un patrón. |
| Sin credenciales | Ninguna credencial. El primer paso protegido debe responder 401 o 403. | Un contrato protege al menos un paso. |
Todos necesitan la API real: en Simulación Luvin no valida lo que envías, así que muestran No se ejecutará. Mira Casos.
La Pokédex no tiene credenciales y sus inputs van en la ruta de la URL, así que solo genera el segundo tipo. El ejemplo de PayPal genera los tres: Create order tiene un amount obligatorio en el body y una API protegida. Mira Prueba un flujo de pago con OAuth 2.0.
2. Abre un workflow con un caso de rechazo
Sección titulada «2. Abre un workflow con un caso de rechazo»- Abre el ejemplo de la Pokédex. Mira el Inicio rápido.
- Haz clic en Type explorer en la barra lateral y abre la pestaña Casos.
Su input type solo permite 18 nombres de tipo. Luvin generó el caso “type” con un valor fuera del enum en el grupo Validación de datos. Junto a él ves Se espera rechazo y API real.

3. Elige el status que debe devolver
Sección titulada «3. Elige el status que debe devolver»Bajo el caso, la línea Status que debe responder «getType»: lista los status que cuentan como rechazo.
- Mira los status. Un punto marca los que el contrato documenta para ese paso. Para
getTypedocumenta 404, así que Luvin lo sugiere. - Lee la línea de al lado: Si responde otra cosa: advertencia. Luvin sugirió el status, así que una respuesta distinta no hace fallar el caso.
- Haz clic en
404. La línea cambia a Si responde otra cosa: error.
Ahora decidiste tú: es lo que afirmas de tu API. Si no eliges nada, vale cualquier 4xx. Un status que no está en la lista se escribe en Otro (Enter). Volver a lo sugerido deshace tu elección. Mira Ajusta un caso.
| Quién eligió el status | Si la API responde otra cosa |
|---|---|
| Luvin, en un caso de Validación de datos | Advertencia: el workflow igual funciona, pero conviene revisarlo. |
| Tú | No pasó |
| Sin credenciales | No pasó |
4. Ejecuta el caso de rechazo
Sección titulada «4. Ejecuta el caso de rechazo»- Haz clic en Ninguno, arriba a la derecha, para desmarcar todos los casos.
- Marca “type” con un valor fuera del enum.
- En la barra de ejecución, elige API real y haz clic en Ejecutar.
Los resultados se abren abajo y el caso termina como Pasó.
5. Lee por qué pasó
Sección titulada «5. Lee por qué pasó»- Haz clic en el caso de la lista. La fila Qué prueba dice qué hace distinto el caso: envía un valor inválido en
type. - Haz clic en Ver valores enviados para ver el valor que se envió.
- Bajo el detalle, abre la tarjeta
getType.
La tarjeta muestra la etiqueta Respondió 404 (esperado) y una nota, Es lo que prueba el caso, con el mensaje de la API después de La API dijo:. El paso se muestra como aprobado porque el error es lo que el caso quiere. Los pasos siguientes dicen que no se ejecutaron, y por qué. Mira Lee el resultado de un paso.
6. Agrega un caso con tus propios datos
Sección titulada «6. Agrega un caso con tus propios datos»Los casos generados no conocen tus reglas de negocio. Agrega uno para una situación propia.
- Abre Pokemon card y su pestaña Casos.
- En el grupo Casos con datos propios, haz clic en + Nuevo caso con datos.
- En Nombre del caso, escribe
Pokémon desconocido. - En Paso que se verifica, elige
getPokemon. - En Acción esperada (opcional), elige
pokemonNotFound (end), y en Status esperado, escribe404. - Bajo Inputs del caso, escribe
QA-{{number:6}}enpokemon. - Haz clic en Agregar caso.
{{number:6}} es un generador: Luvin lo reemplaza por seis dígitos aleatorios en cada ejecución, así que el nombre nunca se repite. Lo mismo vale para {{uuid}} y {{$randomEmail}}. Mira Casos con datos propios.
Desmarca los otros casos y haz clic en Ejecutar. Un caso con datos propios siempre se ejecuta contra la API real. Termina como Pasó cuando getPokemon responde 404 y se activa la acción pokemonNotFound. Haz clic en Ver valores enviados para ver el valor que produjo el generador.
7. Exporta el reporte
Sección titulada «7. Exporta el reporte»- En el encabezado de los resultados, haz clic en Reporte.
- Tu navegador o la app de escritorio descarga un archivo llamado
report-<título>-<fecha>.html.

El archivo tiene un resumen en palabras simples, los contadores, el ambiente, una tabla de casos y el detalle de cada uno. Es un solo archivo: quien lo recibe lo abre en cualquier navegador, sin Luvin. Los secretos y los campos sensibles aparecen como ••••, pero los demás datos de los requests y las respuestas están en el reporte tal como se enviaron. Léelo antes de enviarlo fuera de tu equipo. Mira Reportes.
Qué aprendiste
Sección titulada «Qué aprendiste»- Los casos de rechazo comprueban que la API rechaza un input faltante, un valor inválido y un request sin credenciales.
- Necesitan la API real.
- Un status sugerido por Luvin da una Advertencia cuando la API difiere. Un status que eliges tú da No pasó.
- Un paso que responde el error esperado se muestra como aprobado.
- Los casos con datos propios y los generadores cubren tus reglas.
- Reporte exporta todo como un solo archivo HTML.