What are the different types of APIs?

There isn’t just one type of APIs but actually three main types of APIs:

API types: internal, partner, open APIs

  • Open APIs – aka Public APIs – are publicly available with no access restriction.
  • Partner APIs are APIs exposed by/to the strategic business partners. They are not available publicly and need specific entitlement to access them.
  • Both Open APIs and partner APIs are the tip of the iceberg because they are the most visible ones and are used to communicate beyond the boundaries of the company. They are usually exposed into a public API developer portal that developers can access in a self-service mode. While open APIs are completely open, there is an on-boarding process with a specific validation workflow to get access to partner APIs.
  • Internal APIs – aka private APIs – are usually less known and only exposed by internal systems. They are also often not meant for consumption outside of the company but for being used across different internal development teams for better productivity and reuse of services. A good governance process consists in exposing them into an internal API developer portal that connects to the internal IAM systems to authenticate and authorize users to access the right set of APIs.

API types

Data and service APIs

Beyond the difference between internal, partner and open APIs, we should mention another approach to categorize APIs:

  • Data APIs provide CRUD access to underlying data sets. These APIs are needed to serve some fundamental data coming from SaaS application – with help from SaaS connectors – or internal data stores.
  • Internal service APIs consist in exposing internal services – often legacy SOAP Web Services – reflecting parts of internal processes or some complex actions – into REST APIs.
  • External service APIs are 3rd party services than can be easily embedded into the existing services of the company to bring additional value. – e.g. an external email service like Sendgrid.
  • Composite APIs combine multiple data or service APIs. They are built using API orchestration capabilities of an API creation tool.
  • User experience APIs leverage composite APIs to help app developers provide the right experience for each specific device (desktop, mobile, tablet, VPA, IoT).

8 COMMENTS

  1. […] There’s a ton of information flying around, and there are superstar performers working on the backend orchestrating safe passage of the billions of pieces of data compiled from dozens of scores, records and more. These unsung heroes of the college basketball playoffs are called sport API (Application Program Interfaces) . They might not mean anything to most individuals, but for an organization as large as the NCAA, they mean everything. To know more, check the different types of APIs. […]

  2. […] The world’s hunger for real-time information only grows stronger with each passing day, and this hunger is becoming increasingly met with the practice of retrieving data via an API . Organizations store vast amounts of data, much of it across multiple, disparate databases that are unable to talk to each other. So how can organizations counteract these challenges and find a way to connect disparate data, gaining buy-in from the team? The answer lies in APIs. […]

LEAVE A REPLY

Please enter your comment!
Please enter your name here