Swashbuckle.AspNetCore升级获得类似的操作id

Question

目前使用Swashbuckle.AspNetCore 1.1.0版本的应用程序今年的目标是在.net核心3.1或.net 5上执行框架，同时将Swashbuckle.AspNetCore升级到6.1.5，找出不再具有可操作性，需要自定义的参考https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/master/README.md#assign-explicit-operationids。

我关心的是如何获得相同的操作(与版本1.1.0相同)

下面是我从1.1.0版本中获得的骄傲自大的json结果的示例

具有参数(困难)的api路由

{
    "/api/Games/{id}": {
        "post": {
            "tags": ["Games"],
            "operationId": "ApiGamesByIdPost"
        }
    }
}

正常样本

{
    "/api/Games/Sequence": {
    "get": {
        "operationId": "ApiGamesSequenceGet"
}

我会解决下面的一个使用

options.CustomOperationIds(apiDesc =>
{
          return apiDesc.RelativePath.Replace("/", "") + apiDesc.HttpMethod;
});

但是它只对普通样本进行aby解析，而不对带参数的api路由进行解析。

Answer 1

可以将任何字符串放入HTTP属性中的Name属性中。

[HttpPost("someobject/add", Name = "ApiGamesSequenceGet")]

Swashbuckle将以该值作为操作方法的operationId。