OhAPI Designer para Mac

OhAPI Designer es una aplicación de macOS basada en documentos diseñada específicamente para crear y editar archivos de especificación OpenAPI (anteriormente Swagger). Combina la velocidad de un editor de texto nativo con una profunda conciencia de OpenAPI — completaciones contextuales, validación en línea, navegación estructurada y un panel de operaciones visual — todo en una sola ventana.

Soporta OpenAPI 3.0 y 3.1 en formatos JSON y YAML.

Editor de Código Inteligente

• Resaltado de sintaxis para JSON y YAML con renderizado prioritario de vista — el código visible se resalta instantáneamente, incluso en archivos grandes
• Números de línea, guías de indentación, y resaltado de línea actual para fácil orientación
• Auto-indentación — reglas conscientes del lenguaje para JSON y YAML
• Navegación de migas de pan — ve la posición estructural de tu cursor en el documento (por ejemplo, rutas a /users a get a responses a 200) y haz clic en cualquier segmento para saltar allí
• Modo oscuro y claro — se adapta automáticamente a la apariencia del sistema de macOS

Auto-completado Consciente del Contexto

Presiona Ctrl+Espacio para activar las completaciones. OhAPI Designer analiza la posición de tu cursor dentro del esquema OpenAPI y sugiere claves, valores y referencias válidas. Las claves existentes se filtran, por lo que solo se sugiere lo que falta.

Plantillas de Fragmentos

• Escribe una palabra clave de activación y una vista previa de texto fantasma aparece en línea — presiona Tab para aceptar
• Tabula a través de los marcadores de posición para llenar cada campo, estilo Xcode
• Más de 20 plantillas integradas que cubren estructuras OpenAPI comunes (operaciones, esquemas, parámetros, respuestas, esquemas de seguridad y más)
• Las plantillas se adaptan al formato del documento (JSON/YAML) y a la versión de OpenAPI (3.0/3.1)
• Añade tus propias plantillas personalizadas

Navegación $ref Hacible

Cmd+Click cualquier $ref referencia para saltar directamente a su definición. Las referencias están estilizadas como enlaces subrayados en azul para reconocimiento instantáneo.

Validación OpenAPI

• Subrayados ondulados rojos para errores, ámbar para advertencias — directamente en el editor
• Tooltips de hover muestran el mensaje de error y la ubicación de la fuente
• Validación completa contra las especificaciones OpenAPI 3.0 y 3.1, incluyendo resolución de $ref

Panel de Operaciones

• Tabla de operaciones — todos los endpoints listados con insignias de método HTTP codificadas por colores, rutas y resúmenes
• Vista de detalle con pestañas — Descripción, Cuerpo (parámetros, cuerpo de solicitud, respuestas), Explorador de Esquemas (árbol interactivo con modos Referenciado/Resuelto), y Visor de Ejemplos
• Generación de ejemplos — ejemplos JSON realistas generados desde tus esquemas cuando no se definen
• Haz clic para navegar — salta de cualquier elemento en el panel a su ubicación de origen en el editor
• Actualizaciones en vivo — el panel se actualiza automáticamente a medida que escribes

Más Características

• Conversión JSON ↔ YAML — cambia de formato con un clic en la barra de herramientas
• Asistente para nuevo documento — elige la versión de OpenAPI, formato, y rutas iniciales
• Detección de cambios en archivos externos — recarga automática o diálogo de conflicto
• Consola — registro de eventos codificado por colores con entradas clicables
• Preferencias personalizables — comportamiento del editor, indentación y colores de sintaxis para modo oscuro y claro
• Manual de usuario integrado

Construido para macOS

OhAPI Designer es una aplicación nativa de Swift/AppKit — sin Electron, sin vistas web para el editor. Soporta múltiples documentos en pestañas, guardado automático, y se ejecuta en un entorno seguro de App Sandbox. Disponible para Apple Silicon y Macs Intel.