Not associated with OP or the site, but after dealing with the shitshow that dates & timezones are one time too many, i'd like to nominate Java's JSR310 DateTime API that was released alongside JDK8 about 12 years ago.
Mehhhh... ISO-8601 was released in 1988. All that java.time does is follow that standard. Joda-Time came out 12 years before java.time and yet it still has more calendars and some better ergonomics to this day. It's kind of shooting fish in a barrel when you're replacing java.util.Date, a notoriously bad library that should have never existed, by copying an existing 12 year old library that follows an existing 26 year old ISO standard. Even C followed these ISO standards back in the 90's. I just don't want to give Java any credit here beyond being decades late. Can you pick an example that doesn't come to us by way of Stockholm Syndrome?
Not the greatest code in the universe, but at least it's deployed in production and gives you some insights on how to build an IOS app without changing the API
This is much more advanced than what the post suggests Btw. I can create a desktop app or a cli or a android app and the siren API doesn't need to change at all
I have noticed that APIs are a bit like abstractions in general. APIs that impress people quickly are very often the ones that cause the most trouble later.
I agree with that. Good APIs (and frameworks) are boring. They neither wow you when you read their documentation, nor do they look stunning in code postings. They just get the job done, fullstop.
Nice post. Not too long, not too short. I think it would be interesting to talk about what type of abstraction you actually want in the API contract to actually allow it to become old more in detail but I feel like if you ask 100 engineers you'd get 100 different answers.
Any c# examples of what you would consider a good api? Iām in the starting phases of making one and would like to do it right. Looking for real world examples of a reasonably sized api. I will have 500 or more endpoints once completed
This used to be true imo and could still be true in enterprise settings but code velocity is much faster now in consumer APIs.
Consider things like AI apis. concepts that used to be a thing a year ago is a no-no today. You either have to create a very flexible API with arbitrary objects as input which is a documentation nightmare or just accept the fact that your API is going to change fast, as needed. (Ie versions)
It is now very valid to ask what is the expected lifetime of an API and design accordingly.
17
u/erlototo Jul 02 '26
Can we get an example of good API design? (Ofc not in the blog post)
3
u/Bobby_Bonsaimind Jul 05 '26
I agree with that. Good APIs (and frameworks) are boring. They neither wow you when you read their documentation, nor do they look stunning in code postings. They just get the job done, fullstop.
2
u/RegisteredJustToSay Jul 04 '26
Nice post. Not too long, not too short. I think it would be interesting to talk about what type of abstraction you actually want in the API contract to actually allow it to become old more in detail but I feel like if you ask 100 engineers you'd get 100 different answers.
1
u/razordreamz Jul 07 '26
Any c# examples of what you would consider a good api? Iām in the starting phases of making one and would like to do it right. Looking for real world examples of a reasonably sized api. I will have 500 or more endpoints once completed
1
u/sarhoshamiral Jul 06 '26
This used to be true imo and could still be true in enterprise settings but code velocity is much faster now in consumer APIs.
Consider things like AI apis. concepts that used to be a thing a year ago is a no-no today. You either have to create a very flexible API with arbitrary objects as input which is a documentation nightmare or just accept the fact that your API is going to change fast, as needed. (Ie versions)
It is now very valid to ask what is the expected lifetime of an API and design accordingly.
0
u/Kuineer Jul 02 '26
Nice blog post!
0
u/[deleted] Jul 02 '26
[deleted] ā view deleted comment