{"id":14985654,"url":"https://github.com/schroedermatt/swagger-aggregate","last_synced_at":"2025-09-12T11:41:07.746Z","repository":{"id":139033169,"uuid":"100407528","full_name":"schroedermatt/swagger-aggregate","owner":"schroedermatt","description":"Spring Boot app to aggregate multiple service's Swagger api-docs","archived":false,"fork":false,"pushed_at":"2019-02-13T17:26:47.000Z","size":58,"stargazers_count":24,"open_issues_count":1,"forks_count":13,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-11T22:01:58.064Z","etag":null,"topics":["api-docs","gradle","groovy","spring-boot","swagger","swagger-ui","swagger2","yml"],"latest_commit_sha":null,"homepage":"","language":"Groovy","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/schroedermatt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-15T18:35:45.000Z","updated_at":"2023-08-27T09:21:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"0060a1df-3f14-4395-a43b-5c33c4f03917","html_url":"https://github.com/schroedermatt/swagger-aggregate","commit_stats":{"total_commits":6,"total_committers":2,"mean_commits":3.0,"dds":0.5,"last_synced_commit":"02d401ca127cb56286c65a643bf34f764086af04"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/schroedermatt/swagger-aggregate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schroedermatt%2Fswagger-aggregate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schroedermatt%2Fswagger-aggregate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schroedermatt%2Fswagger-aggregate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schroedermatt%2Fswagger-aggregate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/schroedermatt","download_url":"https://codeload.github.com/schroedermatt/swagger-aggregate/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schroedermatt%2Fswagger-aggregate/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264995219,"owners_count":23694915,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-docs","gradle","groovy","spring-boot","swagger","swagger-ui","swagger2","yml"],"created_at":"2024-09-24T14:11:26.128Z","updated_at":"2025-07-12T13:05:56.235Z","avatar_url":"https://github.com/schroedermatt.png","language":"Groovy","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Swagger Aggregate Service\nSpring Boot service that can aggregate a series of microservice api-docs into a single Swagger-UI.\n\n#### Configuration:\nIn the **application.yml** file, configure all microservice api-docs endpoints. This is what Swagger-UI consumes.\n\n```\ndocumentation: \n  swagger: \n    services:   \n      - \n        name: Important Service\n        url: /v2/api-docs\n        version: 2.0\n      - \n        name: Another Service\n        url: /path/to/api-docs\n        version: 2.0\n```\n\n#### Customizing the api-docs path:\n\nIf you have multiple services running on the same port or are using a load balancer\nthat uses path mappings to determine the target service, you may need to customize\nthe path that is used to serve up the api-docs.\n\nYou can do this via the `springfox.documentation.swagger.v2.path` property.\n\n```\n// application.yml\n\nspringfox:\n  documentation:\n    swagger:\n      v2:\n        path: /path/to/api-docs\n```\n\n\n---\n##### Footnotes\n\nThis application was bootstrapped from \n* [Microservices API Documentation with Swagger2](https://piotrminkowski.wordpress.com/2017/04/14/microservices-api-documentation-with-swagger2/)\n* [Microservices Single Swagger](https://github.com/varghgeorge/microservices-single-swagger)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschroedermatt%2Fswagger-aggregate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschroedermatt%2Fswagger-aggregate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschroedermatt%2Fswagger-aggregate/lists"}