Documentation 在API的网页中记录webAPI

Documentation 在API的网页中记录webAPI,documentation,asp.net-web-api,asp.net-web-api-routing,Documentation,Asp.net Web Api,Asp.net Web Api Routing,我有一个webAPI,其中有许多函数。我想创建一个页面,当用户转到api链接时,该页面将描述api 例如: 我有以下链接: 我的路线如下所示: routes.MapRoute( name: "Default", url: "{action}/operation/{page}", defaults: new { controller = "Home", action = "Index", page = "pin

我有一个webAPI,其中有许多函数。我想创建一个页面,当用户转到api链接时,该页面将描述api

例如:

我有以下链接:

我的路线如下所示:

        routes.MapRoute(
            name: "Default",
            url: "{action}/operation/{page}",
            defaults: new { controller = "Home", action = "Index", page = "ping" }
        );
        routes.MapRoute(
            name: "DefaultPageView",
            url: "{action}/",
            defaults: new { controller = "Home", action="Index", page = "Admin"}
        );
        config.Routes.MapHttpRoute(
            name: "DefaultApi",
            routeTemplate: "{controller}/{action}",
            defaults: new {   }
        );
当用户转到时,我希望将它们转发到存储库中具有API定义(包括所有函数)的页面。我通过如下方式制作HomeController来实现这一点:

    public ActionResult Admin(string page)
    {
        return View("Admin/" + page );
    }
然后,当我进入该网站时,我可以进入一个网页,我将把我的内容放在该网页上,当我单击该网页上的ping链接(该网页是实时的)时,它将使我进入ping描述


我觉得应该有更好的办法。有人知道ASP.NET有什么内置功能可以让它更干净或更好吗?

正如Kiran所说。听起来Web Api帮助页应该可以完成这项工作。您可能需要首先确保您的VS是最新的


检查nuget软件包“Microsoft.AspNet.WebApi.HelpPage”以查看它是否符合您的需要。我已经多次使用此软件包,安装起来非常简单。它会自动扫描您的项目并生成文档,包括示例输入/输出。