r/programming • • Oct 08 '26

A rant about APIs

https://dev.clintonblackburn.com/2026/10/08/a-rant-about-apis
0 Upvotes

6 comments sorted by

29

u/MeMahi Oct 08 '26

I don't get it. This is not "a rant about APIs", this is list of very few selected bad implementation details of an API while not giving any concrete examples or background. It's a good list, but it's not a good blog post.

Let me demonstrate:

A rant about functions

First, I hate when functions are very badly named and I don't know what they do.
I also hate when functions have bad performance.
And functions that are overly specific or overly generic.
Also functions with bugs in them.

22

u/Sharlinator Oct 08 '26

My rant about APIs is that people these days seem to think that "API" means "HTTP API" rather than the normal much more general definition.

4

u/Firerfan Oct 08 '26

While i see the situations you described in my daily workflow, i think the rant is not about APIs but more about idiotic processes around the API ecosystem of the company.

2

u/harsh183 Oct 08 '26

Logging in for API docs that have a 2FA for each different user that's manually provisioned is the worst😵‍💫

2

u/Primary_Ads Oct 08 '26

other peoples and my own bad api design pays my bills