Interfaces
Map the landscape of existing commercial or open-source interfaces available, and develop new ones when needed.
An interface is a promise about how two things will talk to each other, and most organizations have no idea how many promises they have already made. There are APIs bought, APIs inherited, APIs half-built by a contractor who has long since left, and open-source interfaces nobody remembers adopting. Before you build one more, it is worth knowing what you already have.
I map the landscape of interfaces across your operations — the commercial ones you pay for, the open-source ones you depend on, and the internal ones you have quietly accumulated. I document what each one does, where it fits, and whether it should exist at all. Where there is a genuine gap, I help you design a new interface deliberately, using OpenAPI and the wider API family, instead of inventing yet another one-off.
The work is not about chasing the newest protocol. It is about seeing the whole surface of how your systems connect, so you can make decisions about it on purpose rather than by accident.
What you walk away with
- A catalog of the interfaces your operations already rely on
- A clear read on overlap, gaps, and interfaces that should be retired
- OpenAPI-described designs for any new interfaces you genuinely need
Related reading
- Start by Mapping Your API Landscape
- Don’t Do Anything New — Just Map the APIs You Have
- Your Diverse API Toolbox
- API Discovery — the free tool for mapping the interfaces you already have
- APIs.io — search the wider landscape of public APIs
Start with the research
Everything I know about mapping services to capabilities is already written down, priced, and yours to read tonight — no call, no scoping, no proposal. Start there.
-
The Fundamentals of API Discovery $25
You can't govern, secure, or automate what you can't find. -
The Fundamentals of API Reusability $25
Why the same capability gets built five times, and what to do about it. -
Industry Report $500
Every provider in one market, scored on the same public rubric — the distribution, the leaders, the absent incumbents.
Free first: your Kin Score and Agent Readiness are already published on APIs.io. Look yourself up before you buy anything — the score costs nothing and it is the same rubric every report on this page is built from.
If you would rather have this done with you than do it yourself, I take a small number of engagements a year — [email protected].
Newsletters
Two emails, both Monday mornings. Take either, or both.
API Evangelist
Highlights of the stories, conversations, and API knowledge published across the industry each week.
The Specification Layer
What actually merged into the thirty specifications the Linux Foundation stewards — OpenAPI, AsyncAPI, JSON Schema, and the rest.
