API Management 3 min

WSO2EASY – Publishing to Multiple API Stores with WSO2 APIM

Rob Blaauboer
Rob Blaauboer
Integration Consultant & WSO2 Trainer
Multiple APIs scaled

Normally, when you publish an API it will be available in one store. Given the visibility settings it will either be publicly visible, visible to a domain or specific to a role. But what if you want to publish to one or two external API stores as well? Can you do that? Yes you can, quite easily actually. But there are some caveats that you need to be aware of.

How does the mechanism work?

Basically, you point to an external store that is running somewhere on the internet (or your local network). This direction is done using the external-api-stores.xml that is part of the embedded governance repository.

API Mechanism.png

But first things first, let’s set up an external store.

Since it is simple to do this locally, we just unzip a new API Manager with a port offset of 100. That is a random offset that on my machine is open.

Set up external store.png

Start the API Manager using the bat file or the shell script depending on your OS.

Caveat implementor

What we have here is not a distributed deployment of an API Manager or a standalone connected store.

For such a setup, you need to share databases, make changes to the api-manager.xml configuration and so on. In this case the systems are completely separate and the only connection is a configuration (username/password) to the external store. We will show this a bit later in this blog.

The API is actually deployed on the external API Manager (there is a synapse configuration in the repositorydeploymentserversynapse-configsdefaultapi directory). This is almost a carbon copy of the API in the publisher, the only difference is that the external store has a double version number (it is actually defined twice) in the context. To what extent this is a bug or actually part of the mechanism is unclear. It also seems that the image for the API is not copied to the external store environment (the governance repository).


Visitors to the external store will see minimal information about the API. To subscribe the user needs to visit the publisher store. The API will be invoked within that deployment of course.

You can share an API with application developers who are subvisit publisher store.pngscribed to the API Stores of other tenants. This allows you to advertise your APIs to a wider community.

Resources API store.pngSubscribers of other tenant stores can view and browse your APIs; however, the users must visit your (the original publisher’s) store to subscribe to the APIs.

Setting up external stores

You navigate to the Resources section of the Main tab and open the registry. Navigate to /_system/governance/apimgt/externalstores/external-api-stores.xml resource.

Click Edit as Text and make  the following changes:

  <!--Configuration to set the store URL of the current running APIM deployment.
  APIs published to external stores will be redirected to this URL-->
   <ExternalAPIStore id="External" type="wso2"

The parameters are reasonably self-explanatory, basically defining the Store Displayname, Endpoint and the credentials used for accessing the store to publish the API.

External API Stores.png

In a multi-tenant environment, each tenant can publish to different external Stores by changing the above file in their tenant space. As with a non-tenant environment the user needs to visit the original store to subscribe and the invocation will happen over the gateway of the original API Manager.

Publishing to an external store

When the external store is defined an extra TAB is visible in the Publisher once the API is Published.

PizzaShackAPI-1.0.0 External API Stores.png

Selecting the External API Stores tab allows you to check the external store(s) you want to publish to.

PizzaShackAPI-1.0.0-External API TAB.png

When you click Save the API will be available in the external store.

API Store - PizzaShackAPI-1.0.0.png

If you have any questions about this blogpost contact us via the comments section of this blog. View also our WSO2 Tutorials, webinars or white papers for more technical information. Need support? We do deliver WSO2 Product SupportWSO2 Development SupportWSO2 Operational Support and WSO2 Training Programs.

Full API lifecycle Management Selection Guide

whitepaper hero
Get it now
We appreciate it
Care to share

Please select one of the social media platforms below to share this pages content with the world