SwaggerHub

You’re viewing the Catalog Classic docs. To see the new Catalog experience, see the Catalog documentation.

The SwaggerHub integration lets you connect SwaggerHub API specs directly to your Catalog Classic services. You can configure multiple instances of this integration, including multiple connections to the same third-party provider.

For a complete tutorial using the Konnect API, see Import and map SwaggerHub resources in Catalog Classic.

You need a SwaggerHub API key to authenticate your SwaggerHub account with Konnect.

echo '
resource "konnect_integration_instance" "my_integrationinstance" {
  name             = "swaggerhub"
  display_name     = "SwaggerHub"
  integration_name = "swaggerhub"

  config = jsonencode({})
}

resource "konnect_integration_instance_auth_credential" "my_integrationinstanceauthcredential" {
  integration_instance_id = konnect_integration_instance.my_integrationinstance.id

  multi_key_auth = {
    config = {
      headers = [
        {
          name = "authorization"
          key  = "$SWAGGERHUB_API_KEY"
        }
      ]
    }
  }
}
' >> main.tf

This will take you to SwaggerHub, where you can use your SwaggerHub API key to grant Konnect access to your account.

This integration will discover both public and private SwaggerHub APIs in the linked account.

• Automatic resource discovery is supported by this integration
• Resource types: SwaggerHub API version