1. ホーム
  2. yaml

[解決済み] Swagger仕様のJSONをHTMLドキュメントに変換する

2022-11-30 15:44:14

質問

PHPで書かれたいくつかのREST APIについて、私は スワッガー ドキュメントを作成するよう依頼されましたが、それらの既存の API にアノテーションを追加してそのようなドキュメントを作成する簡単な方法を私は知らなかったので、私は このエディタ を使用して、とりあえずいくつか生成してみました。

そのエディタで作成したJSONとYAMLファイルを保存して、あとは最終的にインタラクティブなSwaggerドキュメントを作成します(この発言は甘く曖昧に聞こえるかもしれませんね)。

どなたか、Swagger JSON仕様ファイルを実際のSwaggerドキュメントに変換する方法を教えていただけませんか?

私はWindowsプラットフォーム上で、Ant/Mavenについて何も知りません。

どのように解決するのですか?

には満足していません。 swagger-codegen で満足できなかったので、自作してみました。ご覧ください。 ブートプリントスワッガー

と比較して、主な目標は swagger-codegen と比較して、主な目的は簡単なセットアップを提供することです(ただし、nodejsが必要です)。 そして、スタイリングとテンプレートをあなた自身のニーズに合わせることが容易であるべきで、これは ブートプリント -プロジェクトの中核機能です。