問題タブ [swashbuckle]

ASP.NET Web Api 2 アプリケーションがあります。これに Swashbuckle を追加しました (Swagger for .NET)。エンドポイントは問題なく表示されますが、リクエストを送信するには、そのリクエストに Authorization ヘッダーを添付する必要があります。そのために正しく理解している場合は、index.html ファイル ( https://github.com/swagger-api/swagger-ui#how-to-use-it ) を変更する必要があるため、複製した Swashbuckle プロジェクトを git でindex.html を変更し、いくつかのヘッダーを追加します。

Swashbuckle でリクエストと共に Authorization ヘッダーを送信する唯一の方法ですか?

属性ルーティングを使用する場合、Swagger UI / Swashbuckle で MultipleApiVersions を利用することは可能ですか?

具体的には、次の方法でバージョン管理を実装しました。

バージョン 2 は v2 名前空間にあります。TestV2Controller という名前のコントローラーで。ルートには v2 が含まれます。

これを許可するラムダを渡すことは可能ですか? コンパイルされたラムダのサンプルをオンラインで見つけましたが、Swagger が完全に機能しなくなりました。ブレークポイントにヒットできなかったり、ブラウザーで Swagger を表示できませんでした。

目標:ユーザーが HTTP GET 要求のクエリ文字列にパラメーターを渡すことができるようにする REST API を設計しています。何かのようなもの

実装:サーバー側には、コントローラー アクション メソッドがクエリ文字列を解析する必要がないように、API キー、用語、行の 3 つのパラメーターを受け取り、それらを C# オブジェクトに変換するモデル バインダーがあります。したがって、コントローラーアクションメソッドのシグネチャは次のようになります

問題: Swagger で発生しているのは、ドキュメントとテスト ハーネスを生成するときに、入力パラメーターを request.api-key、request.term、および request.rows としてリストすることです。これは、サーバーから取得する JSON がこれらの値の前にオブジェクト名を付けているためです。したがって、Swagger UI を使用して HTTP GET 要求を実行しようとすると、次のような URL が作成されます。

これは、サーバーに対する誤った要求です。これで、モデル バインダーを簡単にスマートにして、"要求" を無視することができます。一部ですが、それはこの問題を修正する逆方向の方法のようです。

質問:サーバー側で Swashbuckle -> Swagger によって生成された JSON をカスタマイズして、この特定のオブジェクトのパラメーター名にオブジェクト名のプレフィックスが付けられないようにするにはどうすればよいですか? Swashbuckle 拡張 API が公開している ISchemaFilter と IDocumentFilter の両方を調べましたが、これを行うためのクリーンな方法は見当たりません。可能かもしれませんが、その場合は例が役立ちます。

Swashbuckle を使用して、Swagger ドキュメントを ASP.NET Web API プロジェクトに追加します。CSSを挿入せずにドキュメントページからデフォルトのヘッダー(swaggerロゴ付き)を非表示にするにはどうすればよいですか?

現在、私は ASP.Net Web API を開発しており、そのドキュメントには Swashbuckle を使用しています。Swashbuckle が内部で Swagger-UI を使用していることは知っています。css または javascript ファイルを挿入してレイアウトを変更したり、index.html のレイアウトを変更したりできることも知っています。

Swagger-UI https://github.com/jensoleg/swagger-uiに適したテーマを見つけて実装しようとしましたが、機能させることができません。特にbootstrap.jsを注入したいとき。とにかく、Swashbuckle Swagger UI の実装を完全に変更して、そのリポジトリのソリューションを使用できるようにすることはできますか?