{"action":"created","issue":{"url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/issues/30","labels_url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/issues/30/labels{/name}","comments_url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/issues/30/comments","events_url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/issues/30/events","html_url":"https://github.com/MatchMakerExchange/mme-apis/issues/30","id":54822955,"number":30,"title":"Move API version from URL to accepts header?","user":{"login":"buske","id":4251264,"avatar_url":"https://avatars.githubusercontent.com/u/4251264?v=3","gravatar_id":"","url":"https://api.github.com/users/buske","html_url":"https://github.com/buske","followers_url":"https://api.github.com/users/buske/followers","following_url":"https://api.github.com/users/buske/following{/other_user}","gists_url":"https://api.github.com/users/buske/gists{/gist_id}","starred_url":"https://api.github.com/users/buske/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/buske/subscriptions","organizations_url":"https://api.github.com/users/buske/orgs","repos_url":"https://api.github.com/users/buske/repos","events_url":"https://api.github.com/users/buske/events{/privacy}","received_events_url":"https://api.github.com/users/buske/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/labels/PR%20submitted","name":"PR submitted","color":"e11d21"},{"url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/labels/protocol","name":"protocol","color":"5319e7"},{"url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/labels/question","name":"question","color":"cc317c"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/milestones/2","labels_url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/milestones/2/labels","id":950021,"number":2,"title":"v1.0","description":"The version of the API to be published.","creator":{"login":"buske","id":4251264,"avatar_url":"https://avatars.githubusercontent.com/u/4251264?v=3","gravatar_id":"","url":"https://api.github.com/users/buske","html_url":"https://github.com/buske","followers_url":"https://api.github.com/users/buske/followers","following_url":"https://api.github.com/users/buske/following{/other_user}","gists_url":"https://api.github.com/users/buske/gists{/gist_id}","starred_url":"https://api.github.com/users/buske/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/buske/subscriptions","organizations_url":"https://api.github.com/users/buske/orgs","repos_url":"https://api.github.com/users/buske/repos","events_url":"https://api.github.com/users/buske/events{/privacy}","received_events_url":"https://api.github.com/users/buske/received_events","type":"User","site_admin":false},"open_issues":12,"closed_issues":1,"state":"open","created_at":"2015-01-25T01:18:04Z","updated_at":"2015-01-25T01:23:58Z","due_on":"2015-02-28T05:00:00Z","closed_at":null},"comments":1,"created_at":"2015-01-19T22:59:16Z","updated_at":"2015-01-27T18:30:03Z","closed_at":null,"body":"There is immense debate on this topic, but it seems to have become frowned upon to specify the API version in REST URLs."},"comment":{"url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/issues/comments/71700653","html_url":"https://github.com/MatchMakerExchange/mme-apis/issues/30#issuecomment-71700653","issue_url":"https://api.github.com/repos/MatchMakerExchange/mme-apis/issues/30","id":71700653,"user":{"login":"allasm","id":4990078,"avatar_url":"https://avatars.githubusercontent.com/u/4990078?v=3","gravatar_id":"","url":"https://api.github.com/users/allasm","html_url":"https://github.com/allasm","followers_url":"https://api.github.com/users/allasm/followers","following_url":"https://api.github.com/users/allasm/following{/other_user}","gists_url":"https://api.github.com/users/allasm/gists{/gist_id}","starred_url":"https://api.github.com/users/allasm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/allasm/subscriptions","organizations_url":"https://api.github.com/users/allasm/orgs","repos_url":"https://api.github.com/users/allasm/repos","events_url":"https://api.github.com/users/allasm/events{/privacy}","received_events_url":"https://api.github.com/users/allasm/received_events","type":"User","site_admin":false},"created_at":"2015-01-27T18:30:03Z","updated_at":"2015-01-27T18:30:03Z","body":"The current pull request suggests it is possible to have no API version specified by the client and/or the server: \"...If no version is specified, the remote server should respond in the latest version supported by the remote server...\".\r\n\r\nI think that may cause some troubles in the future, since once no explicit version checking is done thing will work fine until some version update will change something and wrong matches will be popping up or matches will be lost - but it will not be obvious what is going on since the queries & responses may be syntactically correct, just not interpreted the same way on the client and the server, or one of the sides may be ignoring some bits of information. Also, not checking versions is the easiest thing to do so if API does not require that we can expect some parties (e.g. some other projects who join MME) to skip the visioning part."}}