問題タブ [swashbuckle]

ApiExplorerを介してすべてのxmlコメントをロードするヘルプページでWebAPIを実行しています(.net 4.5)。スワッシュバックルを介して闊歩を追加したいと思います。そのため、swashbuckle nuget をインストールしましたが、エンドポイントを参照すると、swashbuckle のドキュメントで示唆されているエラーが表示されます。

エンドポイント: localhost:1234/api/company/swagger エラー: {"Message":"Unauthorized request"} またはエンドポイント: localhost:1234/api/company/swagger/apidocs エラー: 404 - 見つかりません

私はステップを逃していますか、それとも間違っていますか??

Nuget パッケージ (Swashbuckle) を使用して Swagger をインストールしようとしていますが、動作させることができません。

これはバニラ VS 2013 Web Api 2 プロジェクトです。JS コンソールに 1 つのエラーがあります: Uncaught TypeError: Cannot read property 'tags' of null.

/swagger/ui/lib/underscore-min.map のリクエストで 404 が受信される

webconfig で vs:EnableBrowserLink を使用して BrowserLink を無効にすることを推奨するリンクを見つけましたが、何の効果もないようでした。

何か案は？

OAuth2 で Swashbuckle 5.0.x を使用しようとしています。OAuth2 の Resource Owner Password Credentials Grant を使用したいと考えています。私は基本的に、最初にトークンを要求し、このトークンを各要求に含めたいだけです (たとえば、スコープは必要ありません)。

誰でもこれを手伝ってもらえますか？swagger/swashbuckle を構成するにはどうすればよいですか?

Swashbuckle を使用して API のドキュメントを生成しています。私のコントローラーメソッドは次のようになります。

Swashbuckle はHttpRequestMessage、生成されたドキュメントでパラメーターとして扱われます。SwashbuckleHttpRequestMessageはテスト目的でのみ署名に含まれているため、無視するように構成する方法はありますか?

新しい Azure API アプリ (2015 年 3 月 24 日の新しい SDK ビットを使用した Visual Studio 2013 のテンプレート) で遊んでおり、Swagger UI で呼び出しをバージョン # でグループ化したいと考えています。私の場合、現在 URI でバージョン管理しています (REST 純粋主義者はこれを行うなと言うでしょう - ここで「エラーを修正」しようとしないでください)。たとえば、次の呼び出しがある場合があります。

機能的には、これはうまくいきます！(はい、うんざりする方もいらっしゃると思います。申し訳ありませんが、これはあなたの気持ちを傷つけます。) しかし、私の問題は Swagger UI 構成にあります。デフォルトでは、Swagger UI はこれらをコントローラー名 (Contactsこの場合) でグループ化します。SwaggerConfig.csこれを変更できるファイルが表示されます。

私が理解できないのは、これを微調整して、すべての「最新」をグループ化し、次にすべての v1 をグループ化し、次にすべての v2 をグループ化する方法です。

これどうやってするの？バージョン番号の代わりに「最新」（または同等）という単語をパスに追加することが絶対に必要な場合は、それを行うことができますが、そうする必要はありません。

Swagger を 1.2 から 2.0 にアップグレードしようとしていますが、操作タイプの取得に問題があります。1.2 では、操作の戻り値を記述するために、操作オブジェクトにデータ型フィールドが含まれていました。しかし、これは 2.0 には当てはまらないようです。

操作オブジェクトの型にアクセスする簡単な方法はありますか?

Swashbuckle 5.1.3 の最新バージョンを使用してSwaggerResponseいますが、応答コードごとに応答タイプを文書化できる新しい属性があることに気付きました。例えば：

( https://github.com/domaindrivendev/Swashbuckle/issues/175 < 役立つかもしれません)。

最初の応答クラスは問題なく文書化されていますが、それが の表を示している場所のさらに下では"Response Messages"、応答モデルは空です (400 Bad Request の場合)。他の応答タイプが文書化されている画面のどこにも表示されません。

ASP.NET webapi プロジェクトで Swashbuckle 5 をすべてデフォルト設定で使用しています。応答のスキーマを表示するために、メソッドの出力をシリアル化します。次のようなドキュメントを取得しています。

これは、次の C# コードによって生成されます

ここで、result.Results は基本的にオブジェクトの標準的なリストであり、それぞれにこれらのキー/値/ID フィールドが含まれています。私はここでhttps://conficient.wordpress.com/2014/05/22/getting-rid-of-k__backingfield-in-serialization/を読みました [serializable] 属性がこれに影響を与える可能性がありますが、それを取り除くつもりはありません可能であれば、属性。このシリアル化アーティファクトを調整するレシピはありますか?