将版本化 api 与 Azure API 管理一起使用时，版本在 url 中出现两次

Question

我已将我的版本化 API 与 swagger 和 Azure API 管理集成在一起。一旦我导入 swagger 定义 API 管理，版本号就会出现两次。有没有更好的方法可以通过 swagger 或 API 管理来做到这一点，这样第二个 V1 就不会出现？

API 管理网址https://my-apimgnt.azure-api.net/myapi-dev/v1/api/v1/user/Skills/get

直接网址/后端 https://jsdevsf.api.mydomain.com/api/v1/user/Skills

[ApiVersion("1.0")]
[Route("api/v{version:apiVersion}/user/[controller]")]
[ApiController]

大摇大摆的定义

{
"swagger": "2.0",
"info": {
"version": "2.0",
"title": "MyAPI 2.0",
"termsOfService": "None",
"contact": {
"name": "mySupport",
"email": "support@my.com"
}
},
"basePath": "/my.Application/my.WebAPI",
"paths": {

    "/api/v1/user/Skills/get/{ProductId}": {}
}

Answer 1

路径相对于 basePath 或 Base URI。

看起来您只需要从您的招摇定义中删除 /api/v1 部分。所以你的定义应该是：

{
"swagger": "2.0",
"info": {
"version": "2.0",
"title": "MyAPI 2.0",
"termsOfService": "None",
"contact": {
"name": "mySupport",
"email": "support@my.com"
}
},
"basePath": "/my.Application/my.WebAPI",
"paths": {

    "/user/Skills/get/{ProductId}": {}
}

要从 Azure 执行此操作，请转到设计 -> 前端 -> OpenAPI 规范编辑器

从这里您应该会看到 basePath 和路径。 Swagger Editor 还应该显示并允许您配置这些值。