The best APIs do not surprise you
A good API should feel almost boring. The names are obvious, the errors are consistent, and the response shape does not change depending on the mood of the system.
- Keep resource names stable
- Return errors in one format
- Version only when the contract truly changes
Predictability is a feature.
When teams move fast, boring APIs become the quiet infrastructure that keeps everything else from wobbling.