Kenneth LeFebvre (@kenlefeb) started discussion #6
I completely agree with your recommendation to "require a version be specified with all requests", however you assert that the best way to do this is in the headers, such as in the Accept header, without really explaining why you think this is the best place to put the version.
Very many APIs in the wild, put their version in the URI path, and that seems to me to be more obvious and in your face, to be sure the developer understands what he's doing. Perhaps I'm missing something about why adding a version to the Accept header is better. Can you clarify please?
Otherwise, thanks for this outstanding resource. I've recommended it to others quite a bit.