OhAPI Designer für Mac

OhAPI Designer ist eine dokumentbasierte macOS-Anwendung, die speziell für das Erstellen und Bearbeiten von OpenAPI (ehemals Swagger) Spezifikationsdateien entwickelt wurde. Sie kombiniert die Geschwindigkeit eines nativen Texteditors mit tiefem OpenAPI-Bewusstsein D kontextsensitives Vervollständigen, Inline-Validierung, strukturierte Navigation und ein visuelles Bedienfeld D alles in einem einzigen Fenster.

Unterstützt OpenAPI 3.0 und 3.1 in JSON und YAML Formaten.

Intelligenter Code-Editor

• Syntaxhervorhebung für JSON und YAML mit viewport-first Rendering D der sichtbare Code wird sofort hervorgehoben, selbst in großen Dateien
• Zeilennummern, Einrückhilfen, und aktuelle Zeilenhervorhebung für einfache Orientierung
• Automatische Einrückung D sprachbewusste Regeln für sowohl JSON als auch YAML
• Breadcrumb-Navigation D sehen Sie die strukturelle Position Ihres Cursors im Dokument (z.B. Pfade D /users D get D responses D 200) und klicken Sie auf jedes Segment, um dorthin zu springen
• Dunkel- und Hellmodus D passt sich automatisch der macOS Systemdarstellung an

Kontextbewusste Auto-Vervollständigung

Drücken Sie Ctrl+Space um Vervollständigungen auszulösen. OhAPI Designer analysiert Ihre Cursorposition innerhalb des OpenAPI-Schemas und schlägt gültige Schlüssel, Werte und Referenzen vor. Vorhandene Schlüssel werden herausgefiltert, sodass nur das fehlende vorgeschlagen wird.

Snippet-Vorlagen

• Geben Sie ein Auslöser-Schlüsselwort ein und eine Geistertextvorschau erscheint inline D drücken Sie Tab, um zu akzeptieren
• Tab durch Platzhalter um jedes Feld auszufüllen, Xcode-Stil
• 20+ integrierte Vorlagen, die gängige OpenAPI-Strukturen abdecken (Operationen, Schemas, Parameter, Antworten, Sicherheitsmechanismen und mehr)
• Vorlagen passen sich dem Dokumentformat (JSON/YAML) und der OpenAPI-Version (3.0/3.1)
• Fügen Sie Ihre eigenen benutzerdefinierten Vorlagen hinzu

Klickbare $ref-Navigation

Cmd+Click auf jede $ref-Referenz, um direkt zu ihrer Definition zu springen. Referenzen sind als blaue unterstrichene Links gestaltet, um sofortige Erkennung.

OpenAPI-Validierung

• Rote gewellte Unterstreichungen für Fehler, bernsteinfarben für Warnungen D direkt im Editor
• Hover-Tooltips zeigen die Fehlermeldung und den Quellort an
• Vollständige Validierung gegen die OpenAPI 3.0 und 3.1-Spezifikationen, einschließlich $ref-Auflösung

Operationspanel

• Operationstabelle D alle Endpunkte aufgelistet mit farbcodierten HTTP-Methodenabzeichen, Pfaden und Zusammenfassungen
• Tabbed-Detailansicht D Beschreibung, Body (Parameter, Anforderungstext, Antworten), Schema-Explorer (interaktive Baumansicht mit Referenziert/Resolviert-Modi) und Beispiel-Viewer
• Beispielgenerierung D realistische JSON-Beispiele, die aus Ihren Schemata generiert werden, wenn keine definiert sind
• Klicken, um zu navigieren D springen Sie von jedem Element im Panel zu seinem Quellort im Editor
• Echtzeit-Updates D das Panel aktualisiert sich automatisch, während Sie tippen

Weitere Funktionen

• JSON D YAML-Konvertierung D wechseln Sie die Formate mit einem Klick in der Symbolleiste
• Neuer Dokument-Assistent D wählen Sie OpenAPI-Version, Format, und Anfangspfade
• Erkennung von Änderungen an externen Dateien D automatisches Nachladen oder Konfliktdialog
• Konsole D farbcodiertes Ereignisprotokoll mit klickbaren Einträgen
• Anpassbare Einstellungen D Editorverhalten, Einrückung und Syntaxfarben für Dunkel- und Hellmodus
• Integriertes Benutzerhandbuch

Für macOS entwickelt

OhAPI Designer ist eine native Swift/AppKit-Anwendung D keine Electron, keine Webansichten für den Editor. Es unterstützt mehrere Dokumente in Tabs, Autospeichern und läuft in einer sicheren App-Sandbox. Verfügbar für Apple Silicon und Intel Macs.