←back to thread

Everything I know about good API design

(www.seangoedecke.com)
428 points ahamez | 1 comments | 24 Aug 25 19:10 UTC | HN request time: 0.209s | source
Show context
pixl97 ◴[24 Aug 25 21:54 UTC] No.45008158[source]▶
While the author doesn't seem to like version based APIs very much, I always recommend baking them in from the very start of your application.

You cannot predict the future and chances are there will be some breaking change forced upon you by someone or something out of your control.

replies(7): >>45008436 #>>45008763 #>>45009169 #>>45009423 #>>45009623 #>>45010511 #>>45010673 #
claw-el ◴[24 Aug 25 22:36 UTC] No.45008436[source]▶
If there is a breaking change forced upon in the future, can’t we use a different name for the function?
replies(7): >>45008467 #>>45008545 #>>45008580 #>>45008683 #>>45009012 #>>45009205 #>>45009223 #
1. ks2048 ◴[25 Aug 25 00:58 UTC] No.45009223[source]▶
If you only break one or two functions, it seems ok. But, some change in a core data type could break everything, so adding a prefix "/v2/" would probably be cleaner.