Estou tentando documentar, via Swagger UI, para consumo interno da empresa, os serviços de API existentes que são desenvolvidos em um produto de fornecedor (WSO2 ESB). O produto do fornecedor não suporta arrogância. Planejo inspecionar / processar programaticamente o código fonte dos meus serviços de API (escritos no produto do fornecedor) e gerar um diretório / pasta / biblioteca de arquivos de definição do swagger no formato .json ou .yml. Tudo bem, eu posso fazer isso.

Cada um desses arquivos de definição de API renderizará muito bem na interface do usuário do swagger, estou procurando usarhttps://www.npmjs.com/package/swagger-ui.

Meu problema é que acabarei com cerca de 100 desses arquivos de definição de API. Gostaria de fornecer uma interface / página abrangente que lista todas as APIs e, em seguida, leva o usuário à Swagger UI com a definição de API específica carregada quando o usuário clica em em um dos links. Isso é equivalente a abrir meu swagger-ui local e digitar / copiar manualmente no caminho para a definição de API relevante. Isso funciona bem se eu fizer manualmente, só não quero que o usuário faça isso manualmente. Como eles saberiam quais URLs de definição de API existem e por que fazê-los digitar / copiá-los manualmente.

Não consigo ver como passar um parâmetro "apiDefintionToLoad" para o Swagger-ui, acho que vou encontrar um ou alterar a fonte para dar suporte a isso. Isso existe?

Existe uma solução melhor, para me desenvolver ou usar um pacote ou solução existente? Eu prefiro soluções baseadas em nó, java também está ok.

Estou indo errado?

Obrigado Matt.