スキーマから静的APIドキュメントを生成しますか？

Question

私はKoa/Expressアプリケーションを手に入れており、さまざまなAPIルートへの注釈に基づいて静的なドキュメントを生成したいと考えています。

スガッガーは良いようですが、私が見つけたパッケージはすべてドキュメントを生成せず、API自体でホストしています。 APIドキュメントをAPIから分離したいと考えています。

これを提供する他のOSプロジェクトのモジュールはありますか？

Answer 1

OpenAPI/Swagger仕様をお持ちの場合は、https://editor.swagger.ioにアクセスしてSwagger Codegenにお試しください。 [クライアントの生成]で[HTML]または[ダイナミックHTML]を選択します

https://restunited.comを使用すると、コードサンプルとともにSDKとドキュメントの両方を生成できます。ここに例があります：http://restunited.com/docs/6y2jvtvkgvst

開示：私はSwagger CodegenとRESTUnited.comの創始者の一人です