How to explain APIs in plain English

How to explain APIs in plain English

APIs play an important role in building today's apps, but how do you explain them to people who aren't developers? Let's talk definitions and business benefits

up
159 readers like this

on

November 01, 2018

The application programming interface, more commonly known by its acronym “API,” may seem kind of old hat. History lessons typically date the API – and especially the Web API – to circa 2000 and the earlier days of online giants like eBay and Salesforce.com. But tech historians also note that APIs really go back much farther than that, long before the modern Web.

So why are APIs still so often misunderstood?

Interest in APIs is getting re-stoked because of the central role they occupy in cloud and cloud-native development.

One possibility: While some of the principles remain the same, APIs have certainly evolved since then and continue to do so. They’ve also gone through multiple cycles of hype, not just in the Web 1.0 and Web 2.0 days but more recently, such as when the phrase “API economy” became popular in the tech lexicon several years ago. That term remains somewhat in vogue today, but interest in APIs is getting re-stoked because of the central role they occupy in cloud and cloud-native development.

As Gordon Haff, technology evangelist, Red Hat, recently told us: “Cloud-native is really just a shorthand for modern application and infrastructure practices. It’s the recognition that businesses across essentially all industries are increasingly reliant on software that can be brought online quickly, adapt to changing marketplace requirements, and run on infrastructure that’s attuned to both rapid changes in demand and new workload types. Think of it as the inverse of the big monolithic application running on a big iron server that evolved on a timescale of years.” (Read also: What are cloud-native applications? by Gordon Haff.)

Within that picture, APIs form critical connective tissue in a microservices architecture, for example.

As a result of this interest in cloud-native, microservices, and APIs, IT pros are likely going to need to be able to explain to others just what an API is and does, sometimes in plain terms that people outside of a software team can understand. That’s harder than it may seem, so we enlisted several experts to help. Let’s start with their clear-cut definitions of an API.

[ Read also: How to explain cloud-native apps in plain English. ]

What is an API?

Barry Walker, software architect at CYBRIC: “An API is a documented way for developers to share pieces of functionality. It’s meant to give developers an easy and standard way to build functionality without having to write all of their own code.”

Bhanu Singh, VP of engineering at OpsRamp: “Essentially, [an API is] a ‘contract’ between two or more independent or interrelated software applications or components that allows these applications or components to communicate and work together.”

Glenn Sullivan, co-founder at SnapRoute: “An API is a set of instructions, written by the developer of an application, which is published for the benefit of other developers. The goal of APIs is to give developers a common, standard method for writing software that builds upon each other.”

"This allows developers to connect different systems, or components of a system, without having to understand all of the complexity."

Mike Kail, CTO at Everest: “The simple definition of API is that it is a URL or set of URLs that expose a service for customers to programmatically access to send and receive information. This allows developers to connect different systems, or components of a system, without having to understand all of the complexity involved.”

Speaking of complexity, non-technical folks are probably going to care less about how APIs work and more about why they’re valuable. Let's talk benefits.

Pages

One comment

This isn't a simplification,

This isn't a simplification, it's trite marketing babble. Plain English? No.

Computers take a formatted input, make calculations, and export a formatted output. API is the standard that establishes the formats of that input and output.

Pages

Kevin Casey writes about technology and business for a variety of publications. He won an Azbee Award, given by the American Society of Business Publication Editors, for his InformationWeek.com story, "Are You Too Old For IT?" He's a former community choice honoree in the Small Business Influencer Awards.

7 New CIO Rules of Road

CIOs: We welcome you to join the conversation

Related Topics

Submitted By Anil Somani
August 23, 2019

Sweeping transformations aren't the only area where organizations need change agents. Here's how to find and nurture people who are eager to make incremental changes every day. 

Submitted By Michael Crones
August 22, 2019

If IT has become disconnected from the business, it may be time to rethink your org chart. Draper's CIO shares how his team forged a tighter business relationship using a new IT role.

Submitted By Jason Lasseigne
August 22, 2019

Balancing high starting salaries for new graduates with those of IT veterans may feel challenging – but it doesn’t have to be. Are you truly taking care of your stars?

x

Email Capture

Keep up with the latest thoughts, strategies, and insights from CIOs & IT leaders.