What is an API? Application programming interfaces explained

Posted on


The time period api It represents Utility Programming Interface, an idea that applies all over the place from command-line instruments to enterprise code, microservices, and cloud-native architectures. An API is an interface that software program builders use to programmatically work together with software program elements or sources exterior of their very own code. A fair easier definition is that an API is the a part of a software program element that may be accessed by different elements.

Until you write every line of code from scratch, you’ll be interacting with exterior software program elements and every of those can have their very own API. Even should you write your entire code from scratch, a well-designed app ought to have inner APIs to assist arrange your code and make your elements extra reusable.

The API is a key idea in software program growth, from easy packages to essentially the most superior architectural and design concerns. This text will make it easier to perceive APIs and the way they’re utilized in software program growth.

APIs in software program growth

An API is the a part of a software program program that may be accessed by different packages. It’s the exterior space of ​​a software program element. Because of this, you might even see a reference to the API floor space of a program The floor space of ​​the API is the outer shell of this system or element, such because the wall of a cell, as proven in Determine 1.

what is a fig1 api IDG
Determine 1. An utility element with its API

When a program is utilized by one other program, we name the primary program the supplier and the second the consumer. The a part of the supplier that’s accessible to purchasers is the API. This association is present in software program functions and methods of virtually every kind. What’s constant is that the API is a approach for purchasers to do calls to the supplier. The API defines a identified vary of allowed inputs and outputs related to the element. Subsequently, the API defines the protocol to speak with a element.

All however essentially the most trivial software program makes use of capabilities supplied by different elements. A software program program calls a element’s API to entry its capabilities. Along with utilizing different elements, most software program is used as a element of different packages, as proven in Determine 2.

what is a fig2 api IDG
Determine 2. A number of elements interacting by way of their APIs

API vs. UI

You could discover some similarities between APIs and consumer interfaces, or UIs. This is sensible as a result of they’re each interfaces. A Interface it’s a technique of interacting with the inner elements of a system. Usually, the job of the interface is to simplify and focus the inner capabilities in a approach that’s helpful to the client. The distinction between APIs and UIs is that they work together with various kinds of purchasers.

On a laptop computer, the consumer interface consists of enter units, equivalent to a keyboard and mouse, and output units, equivalent to a monitor and keyboard. The client is the particular person utilizing the laptop computer. Along with the working system, lots of the packages that run on the laptop computer additionally characteristic a consumer interface that the consumer can work together with by way of the laptop computer’s enter and output units. For instance, the online browser presents a set of visible components on the display that may be managed with the mouse and keyboard.

The browser API

Now, let’s take into consideration that internet browser. We all know {that a} browser is used to open quite a lot of internet pages. Most internet pages load JavaScript as a part of their construction. The browser runs JavaScript to assist show the web page. To operate, the JavaScript program requires entry to the capabilities of the browser. On this case, the JavaScript program is the API consumer and the browser is the API supplier. The browser is a supplier that gives internet searching capabilities which might be accessed by the JavaScript program by way of a programming interface, the browser API.

For instance, should you write F12 proper now and open a JavaScript console, you possibly can write a small JavaScript program to work together along with your browser’s API. In case you enter the code in Itemizing 1 into the console, you will begin to see the output.

Itemizing 1. Mouse monitoring within the browser console

window.onmousemove = operate(e){console.log("mouse cursor:", e.clientX, e.clientY)}

Observe that after you begin seeing console output, you possibly can disable this setting by getting into:

window.onmousemove = null

The purpose of this instance is that the window object is a part of the browser API. He too onmousemove operate (or methodology) is a member of the window object. In flip, it’s a part of the window object API. So when you’re within the code, you can begin to see that APIs are all over the place. If you wish to use the performance of a element, you possibly can entry it by way of the element’s API.

nested APIs

One other statement is that APIs exist at totally different ranges of a program and comprise one another. The window API is, in a way, nested inside the browser API.

Let’s assume somewhat extra about how the browser does its job. It will assist us get acquainted with a few different API varieties. For one factor, how does the browser know the place of the mouse? It registers with the working system by way of an API. The working system then hundreds a mouse driver, which affords a standardized API to supply streaming details about what the mouse is doing. (The controller itself, should you dig additional, finally depends on low-level {hardware} and software program interfaces, a 3rd type of interface together with UI and API.)

APIs in libraries, packages and modules

The browser console is a specialised context during which all libraries are preloaded by the runtime surroundings. It’s extra frequent for the programmer to explicitly load the libraries. How the loading occurs varies by programming language, however everytime you see import, embraceboth require in its output, it signifies that the present program is pulling the API from one other program.

All however essentially the most trivial packages include expressions and language-level constructs (equivalent to ifs, loops, and operators) used along with calls to APIs present in different packages. In flip, every program can be a element that may probably be included and utilized by different packages.

Modules, packages, and libraries are all the identical notion, broadly talking: they’re collections of code that may be included. The sum of its publicly seen elements (courses, objects, strategies, capabilities, variables, and many others.) is the floor space of ​​the API in that assortment.

Distant APIs and microservices

On the highest stage, we may divide APIs into two varieties: native and distant. Distant APIs are helpful as a result of they do not require code updates on consumer units, they will scale independently, they usually current a standardized API kind that any consumer can name so long as they’re approved.

On the whole, lets say that distant APIs (also referred to as providers) are strongly decoupled and provide a commonplace protocol (HTTP/S over TCP) that works independently of the implementation stack behind them.

Let’s arrange a fast interplay with a distant API. Again in your JavaScript console, enter the code in Itemizing 2.

Itemizing 2. Calling the Lord of the Rings API

const fetchData = async () => {
  const rawQuotes = await  fetch('https://the-one-api.dev/v2/quote', {
  headers: {
    'Settle for': 'utility/json',
    'Authorization': 'Bearer xvi06TocPJvBmrQC4yZv'

  const quotes = await rawQuotes.json();
  const quote = quotes.docs[Math.floor(Math.random() *  quotes?.docs?.length)];

  const rawCharacters = await   fetch('https://the-one-api.dev/v2/character?_id=' + quote.character, { headers: headers })
  const characters = await rawCharacters.json();
  const character = characters.docs[0];
  console.log(character.identify + " mentioned: " + quote.dialog);


In case you run this code, you’re going to get a console log, one thing like: “Gollum mentioned: They’re younger. They’re cute. They’re good. Sure they’re. Eat them. Eat them!” What occurred is that you simply created a JavaScript program that used the browser API (particularly, the search API) to difficulty an HTTP name in opposition to the server situated at https://the-one-api.dev That is a REST API, which implies it follows sure architectural conventions.

Microservices and API gateways

A microservices structure it basically makes use of distant APIs for actions that had been historically carried out by the native API. A microservices structure breaks down an utility into elements which might be accessible remotely.

The idea of a API gateway it’s particular to microservices structure. In an API gateway, a single level of contact is outlined within the community to orchestrate routes to particular providers. This enables for sure advantages (equivalent to authentication and charge limiting between providers), and as such capabilities as a type of interface of interfaces.

Distant APIs are all over the place

The Web is mainly a universe of distant APIs that work together. The whole lot operating on a tool is a neighborhood API. Servers are collections of native APIs that conspire to supply a distant API. Purchasers are collections of native APIs that work collectively to eat distant APIs. Middleware is a set of native APIs that conspire to supply one distant API and work collectively to eat different distant APIs.

APIs and good software program design

Throughout all platforms and languages, there are alternative ways to regulate what’s seen and the way it’s utilized by consumer code. API design pays shut consideration to the concept of info hiding, which is the spine of maintainable software program. Good software program design relies on it.

The thought is to write down software program elements that do all the pieces that’s required of them with as little level of contact as attainable. As builders, we need to present solely essentially the most important details about the internal workings of a element. This idea applies to all the pieces from a small operate, whose signature is an API within the effective print, to highly effective distant providers.

Good APIs are the alternative of spaghetti code. In spaghetti code, the movement of execution and dependency could be very troublesome to comply with, making it troublesome to keep up and debug the code. (This is the reason GOTO is taken into account dangerous.)

In good API design, software program elements behave like mechanical elements. They do a selected job behind a well-understood interface. You possibly can deal with the element as a single entity. A automobile’s alternator does one factor: it creates a cost. If it fails, the mechanic can isolate that half. Simply as vital, the remainder of the automobile simply must know that the belt rotates across the alternator pulley. On this analogy, the pulley and electrical terminals of the alternator could be the API of the alternator.

Isolation isn’t good, in fact. Even within the case of an alternator, the situation of the belt and the tensioner work together in vital methods. Builders attempt to create good elements, subsystems, and architectures. We do that to regulate the principle antagonists of software program: the forces of entropy and complexity.

Concentrating complexity on elements and making their interfaces and protocols so simple as attainable makes our software program methods a lot simpler to handle.


APIs are important to good software program design and tackle quite a lot of incarnations within the totally different layers of our software program. Whenever you’re writing software program, it is priceless to consider the code you are writing as a element, probably reusable on different methods. Take into account the API options of your element. In case you do, you will in all probability give attention to a restricted set of options and take into consideration how the API’s floor space will work together with different elements. Assume when it comes to separation of issues and attempt to expose solely the details about your element that’s strictly obligatory.

Utilizing well-designed APIs permits us to compose our software program from logically distinct elements. These elements may be saved in relative isolation and the performance behind them may be reused between totally different functions.

Copyright © 2022 IDG Communications, Inc.

What is an API? Application programming interfaces explained