1. Markdown-Doku für Entwickler-Wiki
Backend-EntwicklerHintergrund
Ein Team hat eine REST-API mit OpenAPI 3.0 spezifiziert und benötigt eine lesbare Dokumentation für das interne Confluence-Wiki.
Aufgabe
Die Roh-OpenAPI-JSON-Datei ist schwer lesbar und muss in eine strukturierte Markdown-Referenz mit Parametern und Fehlercodes umgewandelt werden.
Verwendung
Fügen Sie den OpenAPI-JSON-Code in 'API Quelle' ein, wählen Sie 'OpenAPI JSON' als Quellformat und 'Markdown' als Ausgabeformat. Aktivieren Sie 'Schemas einbeziehen'.
sourceFormat: json, outputFormat: markdown, includeSchemas: true, theme: slateErgebnis
Eine gut strukturierte Markdown-Datei mit allen Endpunkten, Parametern, Antwortbeispielen und Schemas, die direkt ins Wiki eingecheckt werden kann.