Bad developers do not write most bad APIs. Rushed developers do.
I know because I have built a few of them. And one of them still runs in production and requires constant rewriting.
Last quarter I reviewed the Orders API behind our new mobile app. At a glance, it looked fine. But once I read it properly, I found serious issues in it.
Press enter or click to view image in full size
I want to walk you through how I redesigned it. The first few decisions are the basic ones most of us already know.
But the others are often ignored. That is exactly where bad API design starts to hurt.
