After reading this blog, you’ll know the all the main API types and categories and their use cases as part of a robust API program.
Application programming interfaces (APIs) are a flexible way to provide connectivity between systems and their data in your enterprise architecture and ecosystem. We can use them to expose functionality and data in an easy-to-consume way by API consumers and applications. That’s why they’re a key part of modern digital business.
But, there are different types and categories of APIs for different “jobs”. A quick example: if you’re a server a restaurant, you don’t want to come and keep asking the chef if your tables’ food is ready. You listen out for the bell ring from the kitchen that signals “grub’s up!”. That’s the equivalent of picking an event-based API over a REST API.
We’ve put together definitions and examples of the key categories of APIs, as well as the common API types of different protocols/styles. It’s important to know which different type of API you need to ask your API designers and developers to create, so that it’s fit for your use case.
It goes without saying that every enterprise will be using a variety of API types and categories, and so there’s no one-size fits all answer. That being said, in general, you’re likely using a combination of:
These can be broken down into 6 API categories:
And of course, you’re also likely using multiple types of API protocols and patterns, these include:
We see enterprises using the following 6 API categories:
These are your core digital business building blocks. Business capability APIs are essentially the automation of your business functions. Internally or externally visible units of value meaningful to their environment and consumers. They’re further defined by business behavior such as business functions and business processes, implemented for execution by process engines, applications and application services.
Business capability API common subtypes: Internal Private and External Public (e.g. Open APIs/Public APIs)
Example: An Account Management API for a large bank with functions that search for, create, update, and delete customer account details.
System APIs (also known as IT APIs) are those that are mapped to, and integrated with, existing applications. These expose data from back-end systems within your organization within a controlled yet seamless fashion.
System (IT) API common subtypes: Public, Partner Common, Internal Common.
Example: A KYC (know your customer) API which includes face verification, address verification, document verification, 2-factor authentication, and consent verification services.
Partner APIs (sometimes called 3rd party APIs) enable you to bring in external functionality or data from within your API ecosystem. Of course, it’s not always best to spend time and effort building in-house! That’s why this type of API is great for accelerating time to market and ensuring frictionless consumer experiences for your products and services. They’re often accessed using an onboarding and approval process. Postman found in their 2022 state of the API report that partner APIs now account for more than 25% of organizations’ portfolios.
3rd Party API common subtypes: Partner, Public, Partner Private
Example: Subscribing to and integrating the Twilio messaging API to notify customers of product offers available to them.
Point to Point APIs are used to directly integrate endpoints from two or more systems, with a single transform of data in the process. They form a tight coupling and are most commonly associated with legacy services.
Example: An API which takes data from an ERP system and updates an HR database.
Sometimes, back-end systems may be too complicated and “messy” to expose directly. This is where Façade/Experience APIs come in. They expose a streamlined “façade” of the internal system that is much easier for consuming developers to use.
Example: An Audience API that aggregates consumer spending from specific segments of a back-end system of record.
Product Bundles are groups of reusable APIs. A Product Bundle is an encompassing concept and term for enterprises. You may be familiar with the concept of API products and composite APIs, and indeed both can be a Product Bundle.
Enabling bundling of multiple types of service is the next evolution of the API product mindset. For example, a product bundle could contain a REST API, Events-based API, and SOAP service (see later for definitions on these).
The ability to facilitate the continually and innovatively recombination of APIs is a key differentiator for enterprises.
Example: A money transfer bundle containing the account management and KYC APIs from earlier examples (amongst several more).
In addition to the 6 core categories of APIs, there are the following main different API types; architectural styles and/or protocols:
As you mature the API program at your enterprise, you’re likely scaling the numbers of each of these API types. It’s importantly to catalog and manage these APIs holistically, and surround them with rich metadata, to ensure:
However, whilst reading this blog you may be thinking “but my enterprise calls these API types something different!”. That’s almost always the case.
That’s why we suggest looking for an API cataloging tool that has configurable API types like the ignite platform – so you can use your organization’s language. This further helps drive discovery and reuse. And done right, these APIs, Services, and Events encapsulate and modularize your business and technical functions. It’s also important to enable flexible API governance within your organization, as all the different API types and categories will likely need different guardrails surrounding them – ignite can help here too. This is critical to transforming to a composable enterprise.
Want to see how ignite supports different API types and categories? Sign up for one of our live API maturity demo webinars today.
If you have any questions on API Raw Material Suppliers. We will give the professional answers to your questions.