DESARROLLO / API

Generador de Esquema OpenAPI

Genera un esquema OpenAPI 3 válido y descargable a partir de un JSON de ejemplo pegado. Detecta tipos, arrays, objetos y fechas automáticamente.

{}

1 · Pega tu JSON de ejemplo

2 · Configuración del documento

Título

Versión

Nombre del esquema raíz

Cómo funciona

La inferencia de tipos es heurística y basada en el ejemplo: un número entero genera type: integer, un decimal number, un string con formato ISO 8601 genera format: date-time, los objetos se convierten en properties con su lista required (solo claves no vacías), y los valores null marcan el esquema como nullable: true. Los arrays con elementos de tipos distintos se representan con oneOf.

El documento generado es OpenAPI 3.0.3 con components.schemas, info y un endpoint POST de ejemplo cuyo requestBody referencia el esquema raíz. Se descarga como JSON: es el mismo formato que aceptan Swagger Editor, Redocly o Stoplight para validar y visualizar la especificación.

Aviso honesto: un JSON de ejemplo solo captura una muestra. Si tu API tiene campos opcionales, tipos variables o casos vacíos, el esquema generado no los conocerá: úsalo como punto de partida y completa manualmente lo que falte. Todo se procesa en tu navegador; no se envía nada.

Esquema OpenAPI en el navegador

Arma un esqueleto OpenAPI (JSON/YAML) a partir de los campos que rellenas: título, rutas, métodos, modelos. No inspecciona tu servidor ni hace crawling de endpoints. Es un editor de especificación, no un proxy.

El resultado es un punto de partida para Swagger UI o para un contrato de API. Tendrás que completar códigos de error, seguridad y ejemplos. No firma la spec ni la publica en un gateway.

Cómo usarla

  1. Completa metadatos y rutas.
  2. Copia o descarga el YAML/JSON.
  3. Valida con tu linter OpenAPI preferido fuera de esta página si el contrato va a producción.

Límites

No cubre OpenAPI 3.1 al completo ni callbacks. No ejecuta la API. Ficha generador-esquema-openapi. Correo: contacto@1000herramientasweb.com.

Preguntas frecuentes de esta ficha

¿Los datos salen del navegador? No. El JavaScript de esta página trabaja en tu dispositivo. Puedes confirmarlo en la pestaña Red de las herramientas de desarrollador: no verás un POST con el contenido que has pegado. Las únicas peticiones externas, si las hay, son fuentes, el CMP de consentimiento y AdSense cuando lo has aceptado.

¿Puedo usar el resultado en un trabajo profesional? Sí, el archivo o el texto generado es tuyo. Eso no convierte a esta página en un asesor fiscal, legal, médico ni en el software comercial cuyo nombre recuerde el slug. Revisa el recuadro de honestidad si existe y, en documentos con efectos jurídicos, contrasta con un profesional.

¿Por qué existe esta página además del catálogo? Porque quien llega desde un buscador necesita texto que explique la herramienta concreta, no solo un formulario. Esta guía describe el flujo, los límites y un modo de uso. Si encuentras un fallo, escribe a contacto@1000herramientasweb.com indicando navegador, sistema y pasos.

¿Hay cuenta, historial o plan de pago? No. 1000 Herramientas Web no pide registro para usar la ficha. Si cierras la pestaña sin copiar o descargar, el trabajo se pierde. No hay sincronización entre el móvil y el PC. Esa es la contrapartida de no subir tus archivos a un servidor.