c# - 记录 API 模型响应模型

Question

我正在记录一个 API，我想知道如何将响应格式链接到我创建的 ViewModel。ViewModel 有我希望用户浏览的注释。问题是我的控制器返回HttpResponseMessage而不是实际模型本身，因此 WebAPI 帮助页面跳过了记录这一点；

在 HelpPageConfig.cs 我添加了以下内容；

config.SetSampleResponse(xmloutput.ToString(), new MediaTypeHeaderValue("text/xml"), 
   "Course", "Get", new[] { "Id" });

我该如何解决这个问题，并使用 APIExplorer 在帮助页面中创建一个链接。还是必须手动完成？

示例控制器；

[HttpGet]
public HttpResponseMessage Get(string id)        {
   var obj = new Course(id);
   return this.Request.CreateResponse<Course>(HttpStatusCode.OK, obj);
}

Answer 1

我发现了如何使用最近引入的ResponseType属性来做到这一点；

 [HttpGet]
 [ResponseType(typeof(CourseModel))]
 public HttpResponseMessage GetById(string id)
 {