Herramientas API
Selecciona una operación y un cuerpo; usa un ejemplo o genera desde el esquema.
La especificación y los cuerpos permanecen en este navegador; no se envían solicitudes a la API.
Leyendo operaciones…
Los datos de prueba OpenAPI permiten trabajar en la interfaz antes de que el servicio esté listo. Cada fixture se vincula con su operación y estado, para no convertir una respuesta correcta en un caso de error que conserve campos incompatibles.
Al generar datos de prueba desde esquemas OpenAPI, la cantidad cuenta cuerpos completos. Si una respuesta ya es una lista, su longitud se rige por items y los límites del esquema, no por el tamaño del lote elegido en la herramienta.
Los datos de prueba OpenAPI pueden usar una respuesta 400 o 404 declarada igual que una 200. Selecciona su ejemplo con nombre sin modificar la definición. Los ejemplos pertenecen al estado y al tipo de medio elegido; no se mezclan con otras respuestas.
Desactiva la prioridad de ejemplos y fija la semilla para obtener la misma secuencia con el mismo documento y configuración. Conserva también la versión del motor. Un ejemplo explícito o una constante puede seguir igual aunque cambies la semilla.
El ejemplo YAML inicial se analiza automáticamente para rellenar las listas. La solicitud solo genera requestBody; la respuesta depende del estado y el medio seleccionados. Los parámetros de ruta, consulta y cabeceras quedan fuera de este cuerpo.
El example del medio y sus examples con nombre tienen prioridad sobre los del esquema y las propiedades. Si un ejemplo es inválido, se informa del error sin sustituirlo silenciosamente. Desactiva la prioridad para explorar valores permitidos por el esquema.
Una salida JSON conserva la forma original del cuerpo. Varias salidas se envuelven en un array exterior; JSONL guarda un cuerpo completo por línea. Ctrl/Cmd + Intro ejecuta la generación. Los cambios bloquean la exportación hasta volver a generar correctamente.
Busca la operación por método y ruta, y elige un estado, rango o default declarado. El valor inicial prioriza 200, después otro 2xx y después la primera entrada. Los errores tienen el mismo recorrido de selección que los éxitos.
Admite valores integrados, ejemplos con nombre y referencias locales a Example Object. También usa ejemplos aplicables del esquema y sus propiedades. Cada cuerpo se comprueba antes de exportarlo, aunque ya estuviera escrito en examples.
Las solicitudes excluyen readOnly y las respuestas excluyen writeOnly. Se ajustan los elementos required de esa dirección. Si un ejemplo suministrado contiene un campo excluido, se rechaza en vez de borrar el campo sin avisar.
Crea de 1 a 100 cuerpos independientes con una semilla explícita. uniqueItems impone unicidad dentro del array de cada cuerpo, no entre todos los cuerpos del lote. Aumentar la cantidad no cambia los límites internos de las listas del contrato.
Pega el documento completo compatible y selecciona operación, dirección y medio. Mantén la prioridad para usar los ejemplos documentados o desactívala para muestrear el esquema. Si solo tienes un esquema independiente, utiliza el generador dedicado a esquemas.
Selecciona primero el estado y el medio JSON y después el ejemplo con nombre de esa ubicación. Admite valores integrados y referencias locales a Example Object. Los ejemplos del medio prevalecen sobre los del esquema.
Sí, si la operación declara la respuesta con un esquema JSON compatible. Elige 400 o 404 para crear su cuerpo como fixture. La herramienta no envía respuestas HTTP ni provoca fallos en un servidor.
La semilla inicial es 42. El mismo documento y las mismas opciones reproducen el muestreo. example, const y un enum de un solo valor pueden mantenerse iguales con cualquier semilla. Desactiva la prioridad de ejemplos antes de comparar distintas semillas.
No. La validación compara el cuerpo proporcionado o generado con el esquema efectivo compatible. No conecta con la API ni ejecuta middleware, comprobaciones de cabeceras reales, autenticación o reglas de negocio.
¿Qué otra restricción necesitas?
Empieza con un cuerpo de datos de prueba OpenAPI, revisa el estado y su procedencia y aumenta la cantidad cuando el test necesite un lote.