Many enterprise IT departments have become big fans of an “API-first“ strategy. I think that in general, this is a bad idea. (Thread)
37
251
46
592
When you start with APIs, you really have to have a very good grasp of what that API’s users will need. You typically don’t. Instead, you try to come up with things that will “obviously” be re-usable, and end up with things that are not even useful.
4
12
2
103
Most often, APIs are shaped, and almost always restricted, by the capabilities of underlying systems they encapsulate. That’s great if these are great. They typically aren’t.
2
3
44
An API-first strategy assumes that great applications can be built by “just” “orchestrating” the capabilities exposed through APIs. That’s true for some applications, but not for many, and typically not for great ones.
1
3
34
Unless APIs are the actual product you provide to your outside customers, the horizontal divide created by putting an API boundary between your end users and the business logic (and the resulting Conway’s law effects) will create lots of pain and little value.
1
9
1
54
In many cases, an API-centric strategy is a sign of the strategists not wanting to have to deal with actual end users and their needs. It’s much easier to create re-usable services that someone else has to assemble, and even easier to create a meta-strategy for that.
4
17
1
69
(On the plus side, an API-first strategy works great if you have an API gateway product to sell, or want to legitimize legacy systems that are slowing you down by putting a “bi-modal” or “two-speed IT” sticker on them)
1
1
27
I blame most of the disasters in modern enterprise IT strategy on the fact that it’s people like me – backend architects with way too little focus on UI/UX aspects – who have been put at the controls for far too long.
3
16
7
99
You need a strategy for modular application delivery, not only including, but starting from, end-user needs. APIs are a meaningful means to an end for that. Starting with them is going to end badly, independently from your choice of protocol or data format.

Apr 15, 2020 · 9:28 AM UTC

13
27
2
81
Replying to @stilkov
What about GraphQL? :)
1
Replying to @stilkov
The chances are front end is going to be replaced in 5 years with something shinier, but the rest will stay the same (provided you have not screwed it by designing for user interface only).
Replying to @stilkov
I was on board until about the 4th tweet where you declare a heuristic "API devs are lazy people who want to shield from annoying users (paraphrasing)." I think that's rare, and else open their minds and hearts.
Replying to @stilkov
Burning either end of this candle too quickly is ultimately the problem. Balance is key, right? At a certain point in the ‘nimble modular development’ lifecycle, ‘dev’ likely needs to become a first-class consumer of your ‘platform’ or risk drowning in ‘one-off-change’ land.
Replying to @stilkov
Having advocated an API first type of strategy, your thoughts hit home. I have found that API first on its own can struggle. For external, a product/GTM strategy that understands customer use cases is needed. Equiv internal gets into DDD/bounded contexts as other have stated.
Replying to @stilkov
API is an app UI for different users: the devs. It must be approached with the same user experience in mind as the UI for end users, with the same amount of domain knowledge and understanding. Then, it does not matter which is the first. UI is yet another consumer of the app API.
3
Replying to @stilkov
Agree. The underlying issue is that we want to design reusable components : don’t. 1-create specific non-reusable components 2-if another client need similar feature, evaluate if a refactoring is worth to turn it in a reusable one 3-you have a reusable component for real 😀
Replying to @stilkov
We did for some reasonst an UX/UI first approach on some projects. nevertheless .. same problem at least. PO "knows what endusers need" (they did not obviously) So, also this approach didn't work as a charme. We need, no must, communicate with users, bloody early!
1