версия появляется дважды в URL при использовании версионного API с Azure API Managment

Question

Я интегрировал свои версионные API с swagger и с Azure API Management. Номер версии указывается дважды после того, как я импортирую определение API-интерфейса чванства. Есть ли лучший способ, которым мы могли бы сделать это с Swagger или с управлением API, чтобы второй V1 не появлялся?

API ManagmentURL https://my -apimgnt.azure-api.net / myapi-dev /v1 / api / v1 / user / Skills / get

Прямой URL / бэкэнд https://jsdevsf.api.mydomain.com/api/v1/user/Skills

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

Определение Swagger

{
"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, перейдите в Design -> Front End -> Редактор спецификаций OpenAPI

Отсюда вы должны увидеть basePath и paths. Swagger Editor также должен отображать и позволять вам настраивать эти значения.