Swagger Aggregate

application.yml

documentation:
  swagger:
    services:
      -
        name: Animal Service
        url: /animals/api-docs
        version: 2.0
      - 
        name: Human Service
        url: /humans/api-docs
        version: 2.0

build.gradle

compile ('io.springfox:springfox-swagger-ui:2.7.0')
compile ('io.springfox:springfox-swagger2:2.7.0')

PropertyResourceProvider.groovy

class PropertyResourceProvider implements SwaggerResourcesProvider {
    // application.yml props get wired into this config
    @Autowired
    private SwaggerServicesConfig config

    @Override
    List get() {
        config.services.collect { svc ->
            new SwaggerResource(
                    name: svc.name,
                    location: svc.url,
                    swaggerVersion: svc.version
            )
        }
    }
}

service-application.yml

springfox:
  documentation:
    swagger:
      v2:
        path: /{service-name}/api-docs