C# WebAPI HelpPage 自定义 - Url Endpoint

Question

我遇到了一个非常简单的问题，我无法弄清楚如何在搜索结果中使用单词，所以我希望通过解释在这里找到解决方案。

我正在探索 ASP.NET WebAPI 中的帮助页面区域。目前我有一个接受的新端点集：

GET api/status/{id}

但是，当我查看 WebAPI 自动生成的 Helparea 文档时，它会显示：

GET api/status/?id={id}

您能否为我指明正确的方向，找到一个很好的资源来解释如何正确格式化我的 xml cmets，或者解释我需要做什么才能正确生成 Helparea 文档。

我对 ASP.NET 比较陌生，所以如果我需要对此进行澄清，请告诉我，我很高兴。

提前感谢所有帮助和建议。

这是创建端点的地方

    /// GET: api/status/{id}
    /// <summary>
    /// Summary of my endpoint
    /// </summary>
    /// 
    /// <param name="id">summary of the param</param>
    /// <returns>What it returns</returns>
    [AllowAnonymous]
    public IHttpActionResult GetStatus(string id)
    {
    //  Doing stuff here
        return Ok();
    }

这是我的 WebApiConfig.cs

    namespace TestAPI
    {
        public static class WebApiConfig
        {
            public static void Register(HttpConfiguration config)
            {
                // Web API configuration and services
                // Configure Web API to use only bearer token authentication.
                config.SuppressDefaultHostAuthentication();
                config.Filters.Add(new HostAuthenticationFilter(OAuthDefaults.AuthenticationType));

                // Web API routes
                config.MapHttpAttributeRoutes();

                config.Routes.MapHttpRoute(
                    name: "DefaultApi",
                    routeTemplate: "api/{controller}/{id}",
                    defaults: new { id = RouteParameter.Optional }
                );
            }
        }
    }

Answer 1

我已经使用这个配置和端点实现了这一点：

TestController.cs

[RoutePrefix("api/test/v1")]
public class TestController : ApiController
{
    [HttpGet]
    public IHttpActionResult GetStuff(string id)
    {

        return Ok();
    }
}

WebApiConfig.cs

public static void Register(HttpConfiguration config)
{
    // Web API routes
    config.MapHttpAttributeRoutes();

    config.Routes.MapHttpRoute(
                    name: "defaultApiRoutes",
                    routeTemplate: "api/{controller}/{id}",
                    defaults: new { id = RouteParameter.Optional }
                );

}

这是帮助页面上的样子：