在一个有大量资源的 api 的大系统中,我希望以某种配置的方式拆分文档。
就像他们是不同的api一样。
因此,在 web api 的主页中,我有一个配置的“资源”列表。
比方说:管理联系人[这里我想公开'联系人'资源、'地址'资源等。管理订单[产品资源、订单资源、交付资源、余额资源等] 管理产品[产品资源、类别资源, ETC]
因此,api使用者更容易根据任务来理解应该注意哪些方法。
此外,如您所见,不同的部分使用相同的资源,这意味着如果我更改 Product 资源上的某些内容,两个文档都应该(理想情况下)自动更新,包括版本信息等。
编辑:
public ActionResult Index()
{
ViewBag.DocumentationProvider = Configuration.Services.GetDocumentationProvider();
return View(Configuration.Services.GetApiExplorer().ApiDescriptions);
}
这是我对 helpcontroller 的索引操作,不确定您的意思。