問題タブ [swagger-ui]

残りのサービスに Swagger API ドキュメントを使用しています。Swagger をコードに正常に統合しましたが、動作します。

しかし、Swagger UI をフォーマットする必要があります。私のプロジェクトでは応答クラスの数が多いため、Swagger ページは非常に長く見え、ユーザーは情報を表示するために何度もスクロールする必要があります。

そのため、応答モデルのクラスを折りたたんで、ユーザーがクラスをクリックしたときに展開したいと考えています。それを行う方法はありますか?もしそうなら、どこでどのような変更を加える必要がありますか? Swagger-UI.js ファイルを編集しようとしましたが、必要な出力が得られませんでした。

お知らせください。事前に感謝します。

私は Swagger-php と Swagger-UI を使用していますが、すべて問題なく動作しますが、1 つの問題があります。Swagger-UI が作成する UI には、API ルート用の予想されるクリックして展開するセクションがありますが、それぞれのタイトルは、生成された JSON ファイルであり、私が指定できる名前ではないようです。タイトルの後の説明は、私が注釈で付けたものですが、タイトルは私が制御できないようです。

したがって、/foo の resourcePath で始まるルートと、「Foo API 関数」という説明がある場合、UI は次のようになります。

foo.json : Foo API 関数

「foo.json」は必要ありません。むしろ、これが何を言っているのかを指定したいと思います。「Foo」または「Foo 関数」のように、説明をより意味のあるものに変更します。たとえば、「ここに foo 関数があります。」

これに使用する注釈がありませんか?

私はおそらく、こんな質問をしたことで炎上するだろう:

API のエンドポイントを「新規」または「更新済み」としてマークしたいので、開発者が私の闊歩 UI を見ると、最近の追加がすべて表示されます。

そのようなものは存在しますか？

バージョン番号をswagger UIに取得する方法はありますか?

それでは、開発者に各デプロイメントのバージョンを知らせることができますか?

配備しましSwagger UI (version swagger-ui-2.0.8) in tomcatた。これにより、別のドメインの Tibco BW にデプロイされたサービスを呼び出す一連の API が定義されます。これまでのところ、すべて問題なく動作していましたが、Tibco BW サービスを SSL として実装したばかり(uses **https**:xxxxxx:9090/user)です。Swagger send OPTIONS リクエストは、別のドメインの Tomcat にデプロイされて(CORS request).いるため、すべてのレスポンス ヘッダーの CORS を「*」として設定しました。

現在の問題は、swagger からの OPTIONS リクエストに、BW サービスにアクセスするための認証ヘッダーがないことです。これを達成する方法。助けてください

前もって感謝します。

Spring Boot+Jersey+JaxRs アプリケーションを Swagger 用に構成するための例はありますか?

この投稿を参照すると、アプリに以下のコードがあり、swagger UI を表示できず、使用してリソースを一覧表示することもできません

.

ApplicationInitializer クラス: (Groovy)

リソース：

[編集]。私はJersey 1.16を使用していますが、アプリケーションへの影響によりJersey 2を使用できません