When I was younger, I wanted everything to be absolutely correct and small pragmatic perturbations to a design really irked me.
For the last 12 years I have put the api version in the url, it is unambiguous and has never caused a problem. In-band is best, esp for a public service that is consumed in an ad-hoc manner (wget, curl, any http library you can find). Hell, even include the docs in the response.
For the last 12 years I have put the api version in the url, it is unambiguous and has never caused a problem. In-band is best, esp for a public service that is consumed in an ad-hoc manner (wget, curl, any http library you can find). Hell, even include the docs in the response.
Hit https://old.reddit.com/domain/simonwillison.net/.json in Firefox and you can get a long way.