Elige una operación y formato de salida. Añade autenticación, datos de prueba y aserciones de contrato; las pruebas generadas no se ejecutan en esta página.
Se ejecuta localmente en tu navegadorPega un documento OpenAPI 3.x o Swagger 2.0, o abre un archivo local .json, .yaml o .yml. Las rutas, los parámetros, los cuerpos de solicitud y las respuestas se leen en tu navegador, y las operaciones encontradas se listan para que elijas una.
Elige una operación y luego Plan de prueba JSON para ver los casos que conviene cubrir o Vitest + fetch para obtener una base ejecutable que construye la solicitud. Nada se sube y no se llama a ningún endpoint.
Las referencias locales se resuelven hasta su definición: parámetros declarados en una ruta, cuerpos de solicitud y esquemas de components. Los parámetros de ruta se tratan siempre como obligatorios, como exige la especificación, aunque el documento olvide la marca.
Los documentos Swagger 2.0 también se leen. La URL base se compone de schemes, host y basePath, y un parámetro body se convierte en el cuerpo JSON. En OpenAPI 3 se usa la primera URL de servers, sustituyendo las variables de servidor por sus valores predeterminados.
El archivo Vitest importa describe, expect e it; declara cada parámetro de ruta como una constante en camelCase; construye la URL con encodeURIComponent; fija los parámetros de consulta con URLSearchParams; y envía el cuerpo JSON con la cabecera Content-Type correspondiente. Su única aserción es que el estado sea 2xx.
El plan JSON incluye un camino feliz, un caso de entrada ausente por cada parámetro obligatorio (parámetros de ruta y cuerpo incluidos) y un caso por cada respuesta 4xx o 5xx documentada. Ambos formatos leen el documento igual, así que los nombres de los casos coinciden con la base.
Todo se ejecuta en la página y las pruebas generadas no se ejecutan aquí. Un estado 2xx no demuestra que el cuerpo de respuesta cumpla su esquema, así que trata la salida como un borrador que hay que ampliar.
Los documentos muy grandes también se analizan en el navegador; si uno se vuelve lento, recórtalo a las rutas que estás probando. Para revisar antes la propia definición, el validador OpenAPI de la misma categoría informa de problemas estructurales y de referencias.