Just Put the Version in the URL

Nothing gets a debate going around API design quite like versioning. Versioning is when we decide that we need to change an existing endpoint but maintain both the original and the changed implementations. There are two decisions we have to make around versioning. The first is to decide what constitutes a new version. The second is how to model that in our API. ...