asp.net-web-api2 - JSON を使用した Swagger/Swashbuckle ドキュメント POST

Question

Swashbuckle または Swagger に挑戦しています。問題が Swagger にあるのか Swashbuckle にあるのかわかりません。私は、URIパラメーターとしてのパラメーターと、リクエストの本文からのコンテンツの読み取りの両方を実装したWeb API呼び出しを持っています。

1つは次のように実装されています。

    [Route("application/uri")]
    [HttpPost]
    public async Task<string> Post([ModelBinder] Application application)
    {
        return await RegisterApplication(application);
    }

もう 1 つは次のように実装されます。

    [Route("loanapplication/json")]
    [HttpPost]
    public async Task<string> PostByJson(Application application)
    {
        return await RegisterApplication(application); ;
    }

どちらも同じリクエストオブジェクトなどを使用しています。ApplicationRequestクラスには列挙型が含まれていPurposeます。最初のサービスでは、Swagger ドキュメントが美しく作成され、次のApplicationように型の各プロパティに関する優れたドキュメントが作成されます。

ただし、標準の HTTP 本文 POST を使用する 2 番目の方法では、良い JSON の例が生成されますが、列挙型で許容される値は生成されません。これは Swashbuckle や Swagger の欠陥ですか、それともツールの使用方法に関する私の知識不足ですか?

これは、2 番目のメソッドから生成されるものです。

ご覧のとおり、「目的」には最初の可能な列挙値のみが含まれています。また、コンテキストの説明 (ApplicationRequest表示属性として提供される) はどこにも表示されません。