SwaggerHub Integrations

Integrations are a neat way to drive your API lifecycle with connections into your existing toolset. Integrations are bits of software that can be added to your API definition to expand SwaggerHub’s functionality under your control.

GitHub Sync allows generated code to be automatically synchronized with your GitHub repository. That means, no more downloads, merging code, complicated configurations, or scripting. Simply specify the target to generate, the GitHub repository information, and file/folder information and your clients and servers will be always be up-to-date with your Swagger definition. Clients, servers alike can be pushed to one or many repositories.

Webhooks allow you to trigger your own services and integrations during the lifecycle events that you are interested in. When triggered, the Swagger definition is pushed to the service you define for a number of events. Whether triggering a build, a unit test, emailing your developers, or other, you can dream up automation scenarios with SwaggerHub Webhooks.

Testing is key to having a successful well-loved API. So, to accommodate that portion of your API's lifecycle, we built a plugin for Ready! API that allows you to import APIs from SwaggerHub to use in your testing. Importing APIs reads in the Swagger definition and lets you create a variety of tests based on that API definition. But you can also go the other way - when your tests pass, publish your API to SwaggerHub so your collaborators can see it and consumers can find it on our Registry. To find the free plugin, just look in the Plugin Manager inside Ready! API.

As the canonical listing of Swagger APIs, we want to make that information available as broadly as possible. To make it easy for people to use this information in their own applications, we built a Registry API (oh, and of course added it to the Registry…very meta).