Mira la especificación de tu API como un diagrama.
LetDraw es un visualizador OpenAPI que convierte una especificación en un mapa editable de tu API. Pega un archivo OpenAPI 3.x o Swagger 2.0 en YAML o JSON y obtén cada endpoint, agrupado por etiqueta y con un color por método, con flechas hacia los esquemas que usa.
Cómo visualizar una especificación OpenAPI
De openapi.yaml o swagger.json a un diagrama que puedes organizar y compartir.
Toma tu especificación
Usa cualquier documento OpenAPI 3.x o Swagger 2.0, en YAML o JSON. Necesita una sección paths para poder dibujar.
Pégala en Generar desde código
Abre Generar desde código (una función Pro) desde el menú Más herramientas y pega. La especificación se reconoce automáticamente y aparece una vista previa en vivo.
Elige la disposición
Organiza el diagrama de arriba abajo o de izquierda a derecha, y cambia entre un aspecto limpio y uno a mano alzada.
Inserta y comparte
Suéltalo en el lienzo, mueve los elementos, añade notas y luego comparte un enlace o exporta a PNG, SVG o PDF.
Un visualizador OpenAPI que relaciona endpoints con esquemas
Cada operación se convierte en una caja con su método, su ruta y su resumen. Las operaciones se agrupan por su primera etiqueta (o por el primer segmento de la ruta si no tienen ninguna), y cada esquema de components o de las definitions de Swagger tiene su propia caja con sus primeras propiedades. Las flechas siguen cada $ref, desde las operaciones hasta los esquemas que usan y entre esquemas anidados.
- OpenAPI 3.x y Swagger 2.0, pegados como YAML o JSON
- Endpoints agrupados por etiqueta y con un color por método HTTP
- Las flechas siguen cada $ref, así ves qué endpoints comparten un modelo
Un visualizador Swagger para todo el equipo
Una especificación está escrita para máquinas; un diagrama es algo de lo que las personas pueden hablar.
Revisiones de diseño de API
Recorre una API nueva o modificada como una imagen y comenta justo al lado del endpoint en cuestión.
Incorporación
Muestra a los nuevos desarrolladores qué endpoints existen y qué modelos comparten antes de que lean un solo handler.
Documentación para socios e integraciones
Exporta una vista general de tu API pública a PNG, SVG o PDF para guías, portales y presentaciones.
Detectar cabos sueltos
Los esquemas a los que no llega ninguna flecha saltan a la vista, igual que las etiquetas que acumulan demasiados endpoints.
Planificar refactorizaciones
Pega la especificación actual y esboza al lado, en el mismo lienzo, la forma que quieres que tenga la API.
Coordinación entre frontend y backend
Acuerda los endpoints y los payloads en un único diagrama compartido que ambas partes editan en tiempo real.
Preguntas frecuentes sobre el visualizador OpenAPI
¿Qué versiones de especificación se admiten?
¿Mi especificación sale del navegador?
¿Es gratis?
¿Puedo editar el diagrama después?
Más formas de crear diagramas desde código
Tu API, de un vistazo.
Abre LetDraw, pega tu especificación OpenAPI o Swagger y obtén un diagrama que todo tu equipo puede leer.