我正在努力让 API 帮助页面显示我所有的 API 端点,并以我想要的样式显示它们。
这是我的路线:
config.Routes.MapHttpRoute("Orgs", "v1/Orgs/{orgId}",
new { controller = "Orgs", orgId = RouteParameter.Optional });
config.Routes.MapHttpRoute("OrgDescendants", "v1/Orgs/{orgId}/Descendants",
new { controller = "Orgs", action = "OrgDescendants" });
这是我所有的控制器方法:
[HttpGet]
public IEnumerable<Org> GetAllOrgs()
[HttpGet]
public Org Get(string orgId)
[HttpGet]
[ActionName("OrgDescendants")]
public List<Org> Descendants(string orgId)
[HttpPost]
public HttpResponseMessage Post(Org org)
[HttpPut]
public HttpResponseMessage Put(string orgId, Org org)
[HttpDelete]
public void Delete(string orgId)
以下是帮助页面显示的端点:
GET v1/Orgs
POST v1/Orgs
PUT v1/Orgs/{orgId}
DELETE v1/Orgs/{orgId}
GET v1/Orgs/{orgId}/Descendants
如您所见,帮助页面缺少以下端点:
GET v1/Orgs/{orgId}
我已经尝试了很多不同的路由排列,但我已经迷失了方向。无论我尝试什么,我总是会丢失一些端点或“不正确”格式化。
例如,我最终得到:
GET v1/Orgs/{orgId}/Get
当我想要时:
GET v1/Orgs/{orgId}
或者我最终得到:
PUT v1/Orgs?orgId={orgId}
当我想要时:
PUT v1/Orgs/{orgId}
无论我尝试什么组合,我似乎都无法按照我想要的方式得到它们。任何帮助将非常感激!