問題タブ [asp.net-mvc-apiexplorer]

ExpandoObject をパラメーターとして使用することで、Web.API プロジェクトに PATCH メソッドを実装する非常に巧妙な方法を作成しました。以下に示すように：

ただし、ドキュメントを生成するとき、ApiExplorer は ExpandoObject をどうするかについて途方に暮れています。これは完全に理解できます。ApiExplorer を操作して適切なドキュメントを提供する方法について、誰かアイデアはありますか?

私の考えは、期待される実際のタイプを指す新しい属性を導入することでした:

しかし、どこから始めればよいかわかりません。アイデアや提案は大歓迎です。

Swashbuckle を使用して Sitecore WebApi を文書化しようとしていますが、うまくいきません。Swashbuckle.CoreNuget パッケージをインストールし、このロジックをInitializeパイプライン プロセッサに追加しました。

を使用して、ルートにカスタム ルートを追加した後、このプロセッサを実行しますMapRoute。SwashbuckleSystem.Web.Http.Description.ApiExplorerがすべてのコントローラーとアクションのリストを取得するために使用することがわかりました。実際、標準の Sitecore API はすべてリストされていますが、カスタム ルートに追加されたカスタム コントローラーとアクションはリストされていません。経験のある方は、ApiExplorerこれをデバッグする方法を教えてもらえますか? この言及されたバグはまだ問題になる可能性がありますか? ApiExplorerすべてのデフォルトの Sitecore API ではなく、カスタム コントローラーとアクションのみを出力するように を構成できますか?

前もって感謝します！

ASP.NET Core 1.0 は APIExplorer の使用をサポートしていますか? ドキュメントや使用方法を見つけることができません。誰かがそれを使用していて、洞察を共有できますか?

APIメソッドの ヘルプ ページを作成するために、このASP.NET Web API のヘルプ ページの作成およびASP.Net WebApi ヘルプ ページ で説明されているように、xml ドキュメントが使用されています。私のapi's署名の1つは次のようなものです：

PlacesViewModel戻り値の型を文書化する必要があることを除いて、xml 文書は正しい です。実際にPlacesViewModelは、ソリューション内の別のプロジェクトのビュー モデルです。xml コメントは、次のように提供されています。

しかし、それは機能せず、まるでxmlコメントがないかのようPlacesViewModelに、表の説明の列の値が空のヘルプページにクラスが出席します。PlacesViewModelなぜドキュメントを提供できるのかPlacesViewModel

同じプロジェクトに移動すれば、PlacesViewModelうまくいきます！

モデルを返すエンドポイントの場合、 を使用しResponseTypeAttributeて、返されるデータがどのようになるかをヘルプ ページのドキュメントに伝えることができます。

これにより、このエンドポイントがどのように動作するかを説明する Api ヘルプ ページの適切なエントリが作成されます。

特定のエンドポイントがアプリケーション/zip バイナリ ストリームを返すことを文書化したいと考えています。どうやってやるの？