Springdoc z wieloma api-docs

Aug 31 2020

Chcę zgrupować trzy dokumenty API w jednym swagger-ui. Używam Springdoc. Każdy z trzech dokumentów API ma swój własny adres URL. (Nie są w tym samym projekcie). Czy jest na to sposób?

Edycja: teraz działa w ten sposób:

springdoc:
  swagger-ui:
    path: /
    urls:
      - name: App1
        url: http://app1.domain.com/v3/api-docs
      - name: App2
        url: http://app2.domain.com/v3/api-docs
      - name: App3
        url: http://app3.domain.com/v3/api-docs

Odpowiedzi

2 brianbro Aug 31 2020 at 21:30

Odpowiedź jest już dostępna w FAQ:

  • https://springdoc.org/faq.html#how-can-i-agreagte-external-endpoints-exposing-openapi-3-spec-inside-one-single-application

Właściwości springdoc.swagger-ui.urls. * Są odpowiednie do konfiguracji zewnętrznego (/ v3 / api-docs url):

  • Na przykład, jeśli chcesz uzgodnić wszystkie punkty końcowe innych usług w jednej aplikacji. Nie zapominaj, że CORS również musi być włączony.

Szczegóły właściwości dostępne są tutaj:

  • https://springdoc.org/springdoc-properties.html