An API is a contract with the world, and that makes it one of the hardest things to get right in software design.

https://wasteofserver.com/pepsi-broke-the-contract/