モデルを返すエンドポイントの場合、 を使用しResponseTypeAttribute
て、返されるデータがどのようになるかをヘルプ ページのドキュメントに伝えることができます。
/// <summary>
/// returns the specified Foo.
/// </summary>
[ResponseType(typeof(FooModel))]
[HttpGet]
[Route("~/api/foos/{fooId}")]
public async Task<IHttpActionResult> GetFoo(int fooId)
{
...
}
これにより、このエンドポイントがどのように動作するかを説明する Api ヘルプ ページの適切なエントリが作成されます。
特定のエンドポイントがアプリケーション/zip バイナリ ストリームを返すことを文書化したいと考えています。どうやってやるの?