openphoto/frontend — Issue #488: Add versioning to the API (major and minor)
Author: jmathai
Created: 2012-02-05 20:36:09+00:00
State: open

The API should have versioning. Here's the proposal.

==== Major version changes
Anything that breaks backwards compatibility. This would follow `/v[0-9]+/*`

==== Minor version changes
Anything which adds incremental functionality without breaking backwards compatability. The API URL for this doesn't change but it's reflected in a new endpoint at `/v[0-9]+/version.json`. This allows scripts to check for incremental functionality which they depend on.

==== Current URLs
The current API URLs which omit a version will be `v1` which is where we'll start.