Many enterprise IT departments have become big fans of an “API-first“ strategy. I think that in general, this is a bad idea. (Thread)

Apr 15, 2020 · 9:28 AM UTC

37
251
46
593
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
98
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.
13
27
2
81
Replying to @stilkov
Reminds me of the era of (company) framework-first.
1
2
Replying to @stilkov
Wow, quite some opener. I think what you describe applies to ANY product. Including APIs. Doesn't mean API 1st is flawed. What is flawed though is to create a product not based on user (=customer) needs but instead of a deluded idea of enforcing IT 'standards'. Right things right
1
Replying to @stilkov
@bumbleGee interesting thread and relevant for you #ApiFirst #BedenkenSecond 😉
1
Replying to @stilkov
Any approach which starts with a technology prescription is silly. But I agree that any approach where engineers and architects "imagine" what is required is doomed.
1
2
Replying to @stilkov
I think you’re confusing mistakes people make with a bad strategy. If you aren’t building APIs with your UX in mind, you aren’t building APIs right. There’s a BIG learning curve, but saying it’s a bad plan because people make mistakes or ignore constraints is just going too far.
1
1
6
Replying to @stilkov
Seems to be just an extension of the successful practice of defining interfaces between systems. Retreat to implement both sides of the interface. Then shoehorn extra requirements in there by reusing fields because changing the interface is to damn hard.
2
Replying to @stilkov @ewolff
I've always believed clients drive the shape of an API. It's all about ask of the client, which is driven by its UX. Bottom-up design is easy to get wrong.
Replying to @stilkov @ltecarroll
IMHO api-first is an agile anti-pattern. does shipping api’s on their own count as “shippable software” unless the end product is actually an API?
2
4
Replying to @stilkov
Totally agree. I work in payments. We had a set payments apis that totally failed at the first hurdle when ux/ui is introduced. The first thing the users wanted to do was validate an account number and couldn’t.
Replying to @stilkov
Decoupling with a focus on ability to leverage functionality across channels is very different to the business moving toward a platform model to unbudle the firms capabilities to create new value across participants.