You can’t have a conversation with a developer without him mentioning the word API atleast 50 times. In this post I want to explore what the definition of a API is and what types of APIs there are.

Published on 30 June 2017 by Danny de Vries

The definition of APIs — 5 min read

Danny working on a laptop
> Working on a Project

Connectivity is an amazing thing. How do different applications and devices connect to each other? It’s the Application Programming Interface.

APIs create connectivity between applications and devices.

Most computer programs provide data for humans in the form of a User Interface, to make the consumption of the data as enjoyable as possible. Operating Systems all provide GUI’s (graphical user interace) to interact with the system. The user doesn’t really care about the technical stuff. Similarly an API provides a simpler way for developers to interact with other kinds of software. The data needs to be consumed by another program instead of a ‘user’.

As with a UI tailored to humans, software needs an interface that makes it easy to consume data and/or functionality.

The API is the messenger that takes requests and tells the system what to do and returns the response. You can for example access the database of another company. The API has an interface and can ask for information about other systems. You can say that the API is the middleman to communicate between different programs.

The API layer help standardise the coding process. On the web that might be a JavaScript based API, it’s an abstraction of the underlying process.

The Wall Socket Analogy

The programmable web published a great series; what are APIs and How Do They Work?. They have a great little analogy that I want to refer to;

You can think of an API in the context of a wall socket. The electricity is the service and the device is the consumer of that service. The consumer in this case is outsourcing its power requirement to the provider of a service. Electrical sockets have predictable patterns. The plug is standard and the power it delivers (volt) is consistent and mostly the same value. Likewise, an API specifies how software components should interact with each other. J Imagine how you would get power without such a standard.

The Benefits

APIs can not only help developers to write better pograms, it can help the community around the program aas a whole because of the API infrastructure;

On the web this means you can outsource functionality to the browser and add data from other services. Browsers offer a standard way for web applications to access, cameras, audio & bluetooth for example. This is the same for services / apps such as Slack or Twitter. You can use the Real Time slack API to send messages without the Slack interface with just a few lines of code.

Types of APIs

You can ask for specific information by calling endpoints with specific parameters. You basically ask for subsets of the large database from the service. There are no rules of how developers should connect their own applications to an API but several standards have arised.

The first distinction to make is if the API is public or private.

Authentication: If you want to manipulate data from a specific user (the user has to sign in) most APIs use the OAuth open protocol.

An open protocol to allow secure authorization in a simple and standard method from web, mobile and desktop applications

It allows you to interact with protected data from a specific data of a user. For example; add playlists to a specific Spotify account without using a Spotify interface.

Rest API: Most interfaces on the web make connections using the HTTP protocol. You can ask for data using the API endpoint addressable over the web with the HTTP protocol. (GET, PUT, POST & DELETE) You can make a request to a specific endpoint and because an HTTP request is always a round trip you get back the response for use in your own application. On the web most of the time this response is in .json format.

RTM API: Some services take a slightly different approach and instead of using the HTTP protocol they use a WebSocket-based API which allows you to receive events in real time. Instead of asking for information the API can push information to you.

You can achieve a kind of similar result with a Res API by Polling. (Simply calling the endpoint very frequently) Polling is kind off the same as a refresh button. It works but it isn’t the best solution.


To be clear; most of this post cover APIs from other services to request data. There are also specific Web APIs. They are used for manipulating the DOM and can be accessed using JavaScript with object types. The Web APIs extend the functionality of a web browser and thus are browser specific.

Mozilla keeps a nice list of all the cool Web APIs 😎

Hope this post clarifies some of the concepts around APIs, why should you use them and why they are awesome in general!