TNG / ApiCenter

A repository for all your API specifications

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ApiCenter

ApiCenter keeps track of all the services that run in your organization.

It is a API specification repository. You can upload all your OpenAPI (formerly known as Swagger) specifications, so you never have to go look for them anymore. Search through them, test them with SwaggerUI and download them. All in one central place.

It is an interface repository. Some services have more than one interface, or they maintain two versions of the same interface, or something else. ApiCenter can manage them all.

It is, finally, a service repository. If you ever wanted to know which services depend on yours, ApiCenter can help you with the answer. It can also tell you which version they use, to make your changes easier. And, if you want to consume a new service, ApiCenter is also there for you, showing you their interfaces and specs and maybe letting you know about a new version (in the future).

How to run

From source

  • Clone the repository
  • In a terminal, run ./gradlew :runAll
  • In a browser, go to localhost:8080

With Docker

We do not have an official Docker image yet. Until then, you can build your own by cloning the repository and executing the following steps:

  • ./gradlew bootBuildImage
  • docker run -p 8080:8080 tngtech/apicenter

This will start ApiCenter in a Docker container with an in-memory DB.

Built with

Contributing

Please see CONTRIBUTING.md

Versioning

ApiCenter uses semantic versioning. You should expect breakage if the major version changes.

License

ApiCenter is licensed under the Apache 2.0 license.

About

A repository for all your API specifications

License:Apache License 2.0


Languages

Language:TypeScript 64.9%Language:Kotlin 24.8%Language:HTML 8.3%Language:JavaScript 1.2%Language:SCSS 0.8%