Submit support requests and browse self-service resources.
You probably aren’t building your APIs in a vacuum. That's why API orchestration is important.
Read along or jump to the section that interests you most:
API orchestration is the process of integrating applications into a single offering. API orchestration typically requires creating a single API that offers valuable functions to its consumers, often by making multiple calls to multiple different services to respond to a single API request.
Here's how an orchestration layer can help you deliver excellent APIs.
An API is often going to be an externally facing representation of your business. It needs to be nicely packaged, documented, marketed, and supported, but like a birthday gift, no matter how pretty the wrapping, it’s what’s inside that counts. Your API needs to present a clean, elegant interface, built according to modern industry best practices (likely REST or JSON).
The problem is that in most cases (back to our assertion), your API will be built on top of existing services that probably don’t offer clean, elegant interfaces, and rarely use REST or JSON. More to the point, if you look at that last sentence again you’ll see the words API (singular), and services (plural).'
Here’s where API orchestration comes into play with an orchestration layer. You need to create a single API that offers valuable functions to its consumers, often by making multiple calls to multiple different services to respond to a single API request.
It’s easiest to explain this with an example. Imagine a media company (let’s call it MediaCo) that has grown through acquisition and now owns multiple different regional and genre specific content providers. MediaCo needs to publish a catalog of all its content (could be music, TV shows, movies, almost anything), but of course the raw information that would comprise the catalog is distributed across all of its businesses, most likely using different service styles, formats, policies and content.
This is where an API gateway’s orchestration capabilities come in. MediaCo can design the perfect catalog API without having to worry about the structure, style and even content of the various services provided by each of its business, and can use API orchestration to decide how to service each request, and construct service calls appropriately. It could take a request for details on a specific catalog item, use a lookup service to find where this information is, construct a call to a service that has some of the needed content, and use the response or pre-programmed logic to construct one or more calls to other services to get more information.
It’s easy to see how this idea becomes much more powerful when you provide a clean separation between your API orchestration (or process) and the styles, transports and policies of the APIs and services the process is exposing and consuming. See our article on the Anatomy of an API Gateway.
You do have to be a bit careful to make sure that you don’t try and overextend the capabilities of your API Gateway, recognizing that you do most likely have existing development and application platforms. But, that said, it’s nice to have the power and flexibility to use your API Gateway to meet some pretty sophisticated business needs without having to rebuild existing applications and services.
Take our API management platform for a test spin with a 6-month trial.
This blog was originally published in 2013 but has since been updated for accuracy and comprehensiveness.