APIful Blog We're obsessed with Web APIs


Announcing Enterprise API Harmony Beta

Oct 26, 2017 •

When we launched API Harmony we targeted public APIs, APIs available to everyone and discovereable in the open internet. Many APIs, though, the majority of them, live behind the firewalls of the enterprise at many stages in their lifecycle. Customers we spoke to have been looking for ways to organize their APIs as they transform their business, often times not necessarily requiring an API management model, especially in the early stages. They want to catalog APIs to inventory their services, identify duplicate efforts within the enterprise as quickly as possible or find alternate public services that could be consumed.

To address these requirements we have created Enterprise API Harmony in Bluemix. An instance of API Harmony that is “private” to the Bluemix organization where it is created with access to anyone that belongs to the organization. A second instance created in the same organization will point to the original one.

In our last blog post API Harmony now has an API we described how to create an instance of API Harmony in Bluemix. If you follow these steps, once provisioned, you will end up in this screen to launch your organization’s instance of API Harmony:

Figure 1: Enterprise Harmony launch page in your Bluemix Dashboard

At first it just looks like the Public version, except that you will notice a UUID next to the API Harmony title that identifies your organization. This indicates that you are in your own organization’s instance.

We have had Enterprise Harmony available for a while but we waited to write this blog post because we wanted to first announce our APIs. There are three endpoints that only work against the Enterprise Harmony instance:

POST   /oas
PUT    /oas/{id}
DELETE /oas/{id}

They allow you to add, update, and delete new APIs to your catalog. We map your API Key to the corresponding Bluemix org and provide the necessary isolation for your APIs.

Below we show how we add an API via Postman, the famous Petstore API, and then search it:


Figure 2: Addition and search of a private API

API searches work against the private instance but federate to the public one, giving you results from both catalogs and properly labeling each finding with the source catalog where they were found. Your org id is shown on those private APIs.

Note that the URL for your Enterprise API Harmony is https://apiharmony.mybluemix.net/<org_id>. Note that API Harmony continues to be an experimental service in Bluemix with its usual caveats.

We are very much interested on your feedback and how you may use Enterprise API Harmony in your company. Use the comments below or contact us via Twitter.

Share via a Tweet or follow us for everything APIs!