Substitua "host" e "basePath" no nível "/ {path}"

DECLARAÇÃO DE PROBLEMA:

Por uma razão "estranha", todas as nossas operações de uma API têm um "host" diferente. Temos API como esta:

operação 1: GET https: // host1: port1 / api / resourcesoperação 2: GET https: // host1: port2 / api / resources / {id}operação 3: POST https: // host2: port3 / api / resourcesoperação 4: POST https: // host2: port4 / api / resources / search

Se usarmos o Swagger / OpenAPI como está, significa criar uma especificação Swagger / OpenAPI por operação, resultando em uma página swagger-ui por operação e, em seguida, na necessidade de recriar uma página de índice para listar todas as operações de um API: - / que é exatamente o que queremos evitar.

QUESTÕES:

1 / Esse recurso - Substituir "host" e "basePath" no nível "/ {path}" - faz sentido?

2 / Alguém já tenta implementar esse recurso no swagger-ui?

3 / Posso / devo propor esse tipo de alteração ao OpenAPI?

Quaisquer outras observações / comentários úteis são bem-vindos ;-)

questionAnswers(2)

yourAnswerToTheQuestion