Excellent article about API versioning by @philsturgeon: blog.apisyouwonthate.com/api…

Evolution is the only sensible approach. We've been doing it for years on the protocol layer (protobuf, thrift, ...) and things just WORK.