layman/terms
Apps talking to apps

API

ay · pee · eye — Application Programming Interface

In shortA set of agreed requests one app can make to another, like “give me today's weather” or “take this payment”.

Apps constantly ask other apps for things: the weather, a map, a payment. An API is the front desk they ask at.

In a hotel, you don’t wander into the kitchen or the laundry. You go to the front desk. You ask for a taxi, extra towels or a late checkout. The desk knows how to get it done. You never see how.

An API is that front desk for software. It’s a list of requests one app is allowed to make to another, with exactly how to ask for each one. The app doesn’t need to know what happens behind the desk.

You use APIs all the time

Why they matter

APIs let companies build on each other instead of starting from scratch. A small shop doesn’t build its own payment system. It just uses a payment company’s API.

What it isn’t

It isn’t an app you open. Nobody sees an API. It’s the agreed way two pieces of software talk.

Where the comparison breaks down

A front desk might bend the rules for a friendly guest. An API won’t. Requests must be made in exactly the right format or they’re refused.

How the words fit together

An API has endpoints, one per kind of request. You prove who you are with an API key. A webhook is the API calling you back when something happens.

Good to know

When an app says it “connects with” another service, it's almost always using that service's API behind the scenes.

When you'll hear it

“Do they have an API?” Can our software talk to their service directly, without a person clicking around?

“We'll call their API.” Our app will send their service a request and use the answer.

“The API changed and broke our app.” They changed how requests work, so ours stopped being understood.

Say it in a meeting

“Does this service have an API, so we can connect it to our tools instead of copying things by hand?”

Try it yourselfReady to use it? The exact commands are on my other site, devcmds: Call an API from the terminal ↗