Swagger 被具有不同 URL 的第二个 HttpPost 端点混淆

Question

我有以下 API 端点。

[Authorize]
[HttpPost]
[Route("{companyCode}")]
public async Task<IActionResult> GetSearchResultsAsync(TripSearchDto tripSearch, string companyCode, int? page = null) =>
    await SearchResultsCommonAsync(tripSearch, companyCode, false, page);

这很好用。 但我需要添加一个返回额外数据的版本，但我想在不破坏现有 API 的情况下进行。

所以我在 URL 中添加了第二个带有“ex”段的。

[Authorize]
[HttpPost]
[Route("ex/{companyCode}")]
public async Task<IActionResult> GetSearchResultsExAsync(TripSearchDto tripSearch, string companyCode, int? page = null);

这似乎也可以正常工作。

然而，swagger 似乎对此感到困惑。

有没有人在这里看到问题，或者我该如何解决？

如果我尝试直接导航到https://localhost:44360/swagger/v1/swagger.json ，则会出现错误。

Answer 1

这两种方法都依赖于我无意中公开的通用方法。

将该方法（不是端点）设为私有解决了这个问题。

Answer 2

而不是发布然后路由，尝试

HttpPost("{companyCode}")

和

HttpPost("ex/{companyCode}")