The API decision your business is making without realising it

Your business connects systems by API all the time — the website talks to the payment provider, the CRM to the accounting package, one tool to another. To most non-technical leaders, an API is a plumbing detail handled by developers. It is not. Every API integration is an architectural commitment with consequences that outlast the convenience that prompted it, and businesses make these commitments constantly without realising a decision is being made at all.

What an API actually is, in business terms

An API is the agreed way two systems talk to each other — a contract that says “ask me in this way and I will respond in that way.” When you integrate two systems, you are not just passing data between them; you are committing to that contract, and to the relationship it creates. Your system now depends on the other one behaving as expected, staying available, and not changing the rules. That dependency is the decision, and it is invisible until something on the other side changes.

What you are actually committing to

Each integration commits you to several things at once. You commit to a dependency: if that system goes down, changes its API, or raises its prices, your business feels it. You commit to a data relationship: information now flows between systems, and if they disagree about what the data means, you inherit the conflict. You commit to a coupling: the more tightly your systems are wired together, the harder any one of them is to change or replace later. None of this is bad in itself — integration is how modern businesses work — but it is a commitment, and commitments accumulate.

Free · 4 minutes

If your most senior engineer left tomorrow, would anyone still understand the system?

Fourteen questions on documentation, dependencies, and the gap between how the architecture works and how many people know it. Banded finding on screen, full sheet by email.

The trouble comes when these commitments are made one at a time, by whoever is closest to the task, with no overall view. That is how a business ends up with a tangle of point-to-point connections nobody designed — the situation reached in when Zapier stops being enough — and how disconnected systems develop the data conflicts described in when your systems don’t talk to each other.

Why it deserves a decision

Because each integration is a commitment, the sensible questions are the ones rarely asked before the connection is made. How critical does this dependency become — what happens to us if that system fails or changes? Is this the right way to connect these systems, or are we creating a tangle we will regret? Does the data flowing across actually agree at both ends? And is this integration part of a deliberate design, or just the quickest way to solve today’s task? Asking them takes minutes. Not asking them is what produces architecture by accident.

The same principle applies underneath, at the data layer, where the database decision sets the foundation everything else connects to. APIs and data models are two sides of how your systems fit together, and both reward being decided rather than defaulted into.

Every API integration is an architectural commitment. I will help you understand what you are committing to before you commit to it.

Start a Conversation

Build and rescue work

Hands-on delivery of this kind is handled by Sixteen Pillars Studio.

Free interactive tool

Website compliance checklist

What your site has to do, based on what it actually does

Answer as much or as little as you like — the list builds as you go. Nothing is stored against your name and no email is required.

Can you trust the architecture you have?

Architecture diagrams rarely show the reality of how systems actually operate. An independent review establishes what is really there.