複数のスワッガーファイルでのswagger-codegenの使用

このプロジェクトでは、1つのAPIに複数のスワッガーファイルを使用していますが、swagger-codegenでは1つのみを使用できます。この場合、swagger-codegenでコードを生成するにはどうすればよいですか？複数のスワッガーファイルでのswagger-codegenの使用

出典

2016-12-06 LookingToLearn

相対スキーマファイルを使用できます。例えば

$ref: 'Pet.yaml'

参考：https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#relative-schema-file-example

闊歩ファイルがリンクされていない場合は/相互に関連し、その後、あなたは、単一のファイルに闊歩ファイルを結合し、操作を分類するtagsを使用する必要があります。例えばwing383 @

出典

2016-12-06 05:52:22

ありがとう、これはマスター闊歩ファイルは何とかそれがすべて一緒にリンクされることを作成する必要があることを示唆しているのでしょうか？現在、6つのJSON swaggerファイルがあり、すべて独自の情報とタグを持ち、一緒に1つのAPIを定義しています。これは珍しいアプローチですか？ – LookingToLearn

あまりにも多くのエンドポイント/操作を1つのAPIに入れすぎないようにするために、巨大なAPIを小さなAPIに分解する開発者がいくつかのSwagger仕様を前にしていました。特定のシナリオでSDKのサイズが問題になることがあるため、SDKのサイズを小さくすることは悪い考えではありません。 APIを1つにまとめるかどうかは、実際にはユースケースになります。 –

ありがとう、私はまだローカルの使用のためにそれらを組み合わせる方法や$ refがどのように役立つかについてはまだ分かりませんが。私はソース・スワッガー・ファイルを使って作業していますが、どういうわけか私が働いている会社は、それらをドキュメントと一緒に公開するために1つのファイルにまとめています。私は手動でコピーアンドペーストやそれらを組み合わせるスクリプトを一緒にハッキングしていないテスト中に同じローカルで行うことを望んでいます。 – LookingToLearn

複数のスワッガーファイルでのswagger-codegenの使用

答えて

関連する問題