Referencia
Preguntas frecuentes
Respuestas cortas a las preguntas que más hacen testers y gente de producto, cada una con un enlace a la página que la explica completa.
Respuestas cortas, cada una con un enlace a la página que profundiza.
Sobre Luvin
Sección titulada «Sobre Luvin»¿Para qué sirve Luvin?
Sección titulada «¿Para qué sirve Luvin?»Luvin prueba una cadena de llamadas a APIs, llamada workflow, donde cada llamada usa datos de las anteriores. Diseñas el workflow a partir de tus contratos, lo ejecutas y lees un veredicto en palabras simples. No es una herramienta de automatización ni de orquestación. Mira Qué es Luvin.
¿Necesito una cuenta?
Sección titulada «¿Necesito una cuenta?»No. Luvin no tiene backend ni cuenta. Lo abres y trabajas. Mira Privacidad y seguridad.
¿Mis datos se envían a algún lado?
Sección titulada «¿Mis datos se envían a algún lado?»No. Todo corre en tu equipo, en el navegador o en la app de escritorio. El único tráfico son los requests que ejecutas contra tus propias APIs y los contratos que decides descargar desde una URL. Mira Privacidad y seguridad.
¿Qué es Arazzo?
Sección titulada «¿Qué es Arazzo?»Arazzo es un estándar abierto de la OpenAPI Initiative para describir una secuencia de llamadas a APIs en un archivo. Luvin lo escribe por ti cuando diseñas un workflow, y lo lee cuando abres uno. Mira La vista del archivo Arazzo y el Glosario.
¿Qué versiones de las especificaciones soporta?
Sección titulada «¿Qué versiones de las especificaciones soporta?»Arazzo 1.0 y 1.1, OpenAPI 3.x, y AsyncAPI 2.x y 3.x. Mira Soporte de especificaciones.
¿Puedo usar Luvin en español?
Sección titulada «¿Puedo usar Luvin en español?»Sí. La interfaz, los mensajes y el reporte HTML están en español y en inglés. Cambia el idioma en Preferencias. Mira Recorrido por la interfaz.
Para empezar
Sección titulada «Para empezar»¿Puedo usarlo sin OpenAPI?
Sección titulada «¿Puedo usarlo sin OpenAPI?»Sí. Arrastra requests guardados al canvas en lugar de operaciones de un contrato. Puedes crear requests desde cero, importar un comando cURL o importar una colección de Postman o Bruno. Mira Armar desde requests guardados y Trae tus propios archivos y requests.
¿Tengo que escribir YAML?
Sección titulada «¿Tengo que escribir YAML?»No. Diseñas en el canvas y Luvin escribe el archivo Arazzo. Mira Diseñar un workflow.
¿Puedo editar el YAML a mano?
Sección titulada «¿Puedo editar el YAML a mano?»Sí. La pestaña YAML es el mismo archivo que edita el canvas. Lo que escribes a mano se conserva, y la pestaña lo valida mientras escribes. Mira La pestaña YAML.
¿Dónde se guardan mis archivos?
Sección titulada «¿Dónde se guardan mis archivos?»En la carpeta del workspace que elijas: una carpeta con una subcarpeta por colección, todo en archivos de texto. Sin workspace, la sesión se guarda en este dispositivo. Mira Qué hay en el disco y Usar Luvin sin workspace.
¿Puedo trabajar con mi equipo en git?
Sección titulada «¿Puedo trabajar con mi equipo en git?»Sí. Un workspace es una carpeta de archivos de texto y los valores de los secretos no están en ellos, así que puedes hacer commit. Mira Llevar un workspace en git.
Ejecutar y resultados
Sección titulada «Ejecutar y resultados»¿Cuál es la diferencia entre API real y Simulación?
Sección titulada «¿Cuál es la diferencia entre API real y Simulación?»API real envía los requests a las URLs del ambiente activo. Simulación responde con los ejemplos del contrato, sin red y sin credenciales. Mira Simulación.
¿Por qué la ejecución se pausa con un diálogo sobre una lista?
Sección titulada «¿Por qué la ejecución se pausa con un diálogo sobre una lista?»Un paso devolvió una lista y un paso posterior la usa, así que Luvin pregunta con qué elemento continuar. Contra la API real pregunta incluso cuando la lista tiene un solo elemento. En Simulación pregunta solo cuando la lista tiene más de uno. Mira Elige un elemento de una lista.
¿Por qué un caso terminó en Advertencia?
Sección titulada «¿Por qué un caso terminó en Advertencia?»Un caso en Advertencia es un caso de validación de datos donde la API respondió un status distinto del que sugirió Luvin, normalmente aceptando datos que el contrato dice que debía rechazar. El workflow sigue funcionando. Mira Por qué falló un paso o un caso.
¿Por qué un caso es No concluyente?
Sección titulada «¿Por qué un caso es No concluyente?»Luvin no pudo juzgarlo: la API no respondió, o el workflow se detuvo antes del paso que el caso revisa. Corrige el problema anterior y ejecuta de nuevo. Mira Lee los resultados.
¿Por qué falló un paso si la API respondió 200?
Sección titulada «¿Por qué falló un paso si la API respondió 200?»No se cumplió un criterio de éxito del paso, por ejemplo un dato con otro valor. Abre el paso: el motivo dice qué se esperaba y qué llegó. Sin criterios, cualquier 2xx pasa.
¿Por qué la API no responde en el navegador?
Sección titulada «¿Por qué la API no responde en el navegador?»En el navegador, la API que pruebas debe permitir CORS desde el origen de la app. Luvin muestra los headers exactos que hay que agregar. La app de escritorio no tiene la restricción de CORS. Mira Ayuda de conexión.
¿Una ejecución real cambia datos en mi API?
Sección titulada «¿Una ejecución real cambia datos en mi API?»Puede hacerlo. Los pasos con POST, PUT, PATCH o DELETE envían requests reales al ambiente, y Luvin te pide confirmar antes de ejecutarlos. Elige un ambiente de pruebas o usa Simulación. Mira Ejecutar.
¿Cómo comparto los resultados?
Sección titulada «¿Cómo comparto los resultados?»Pulsa Reporte en el encabezado de los resultados para obtener un reporte HTML autocontenido y sin credenciales, o JSON para exportar los resultados. Mira Reportes.
Secretos, ambientes y límites
Sección titulada «Secretos, ambientes y límites»¿Dónde se guardan los secretos?
Sección titulada «¿Dónde se guardan los secretos?»En los archivos del workspace solo se escriben los nombres de los secretos. Los valores quedan cifrados en tu equipo, con el llavero del sistema en la app de escritorio. Mira URLs base, variables y secretos.
¿Soporta OAuth 2.0?
Sección titulada «¿Soporta OAuth 2.0?»Sí. Se configura por API o por workflow sin cambiar el Arazzo; el token se obtiene una vez y se reutiliza. Mira OAuth 2.0.
¿Soporta Kafka, AMQP o MQTT?
Sección titulada «¿Soporta Kafka, AMQP o MQTT?»Todavía no. Los pasos de AsyncAPI funcionan, pero siempre se simulan con los ejemplos del contrato, también en una ejecución real. Mira Pasos de mensajería y Limitaciones conocidas.
¿Puedo ejecutarlo en CI?
Sección titulada «¿Puedo ejecutarlo en CI?»Luvin es una herramienta para diseñar, depurar y mostrar workflows. No es un runner de CI. Los archivos Arazzo que escribe se pueden llevar a una herramienta que ejecute Arazzo en CI, como Redocly Respect. Mira Limitaciones conocidas.
¿Uso la app de escritorio o el navegador?
Sección titulada «¿Uso la app de escritorio o el navegador?»Usa la app de escritorio si necesitas cookies, no tener límites de CORS, carpetas reales, el llavero del sistema, gRPC o una terminal. El navegador sirve para una prueba rápida. Mira Instalar y abrir Luvin.
¿Cómo genero datos aleatorios, como un email nuevo en cada ejecución?
Sección titulada «¿Cómo genero datos aleatorios, como un email nuevo en cada ejecución?»Escribe una plantilla como {{email}} o {{$randomUUID}} en un valor. Mira Variables dinámicas y Expresiones de runtime.