{"action":"created","issue":{"url":"https://api.github.com/repos/json-api/json-api/issues/600","labels_url":"https://api.github.com/repos/json-api/json-api/issues/600/labels{/name}","comments_url":"https://api.github.com/repos/json-api/json-api/issues/600/comments","events_url":"https://api.github.com/repos/json-api/json-api/issues/600/events","html_url":"https://github.com/json-api/json-api/issues/600","id":74053253,"number":600,"title":"Proposal to reserve \"version\" member at top level of resource objects","user":{"login":"scott-mcdonald","id":8608244,"avatar_url":"https://avatars.githubusercontent.com/u/8608244?v=3","gravatar_id":"","url":"https://api.github.com/users/scott-mcdonald","html_url":"https://github.com/scott-mcdonald","followers_url":"https://api.github.com/users/scott-mcdonald/followers","following_url":"https://api.github.com/users/scott-mcdonald/following{/other_user}","gists_url":"https://api.github.com/users/scott-mcdonald/gists{/gist_id}","starred_url":"https://api.github.com/users/scott-mcdonald/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/scott-mcdonald/subscriptions","organizations_url":"https://api.github.com/users/scott-mcdonald/orgs","repos_url":"https://api.github.com/users/scott-mcdonald/repos","events_url":"https://api.github.com/users/scott-mcdonald/events{/privacy}","received_events_url":"https://api.github.com/users/scott-mcdonald/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/json-api/json-api/labels/enhancement","name":"enhancement","color":"84b6eb"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/json-api/json-api/milestones/2","html_url":"https://github.com/json-api/json-api/milestones/JSON-API%201.1-beta","labels_url":"https://api.github.com/repos/json-api/json-api/milestones/2/labels","id":1196038,"number":2,"title":"JSON-API 1.1-beta","description":"1.1-beta launch.","creator":{"login":"tkellen","id":1004324,"avatar_url":"https://avatars.githubusercontent.com/u/1004324?v=3","gravatar_id":"","url":"https://api.github.com/users/tkellen","html_url":"https://github.com/tkellen","followers_url":"https://api.github.com/users/tkellen/followers","following_url":"https://api.github.com/users/tkellen/following{/other_user}","gists_url":"https://api.github.com/users/tkellen/gists{/gist_id}","starred_url":"https://api.github.com/users/tkellen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tkellen/subscriptions","organizations_url":"https://api.github.com/users/tkellen/orgs","repos_url":"https://api.github.com/users/tkellen/repos","events_url":"https://api.github.com/users/tkellen/events{/privacy}","received_events_url":"https://api.github.com/users/tkellen/received_events","type":"User","site_admin":false},"open_issues":2,"closed_issues":0,"state":"open","created_at":"2015-07-07T02:28:26Z","updated_at":"2015-07-07T02:35:38Z","due_on":"2015-09-30T04:00:00Z","closed_at":null},"comments":15,"created_at":"2015-05-07T16:48:15Z","updated_at":"2015-07-24T16:09:40Z","closed_at":null,"body":"Currently each resource has \"identity\" via the \"type\" and \"id\" top-level keywords at the top-level of a resource, but a resource can be at a different \"version\" based on updates, etc.\r\n\r\nI propose adding an *optional* top-level resource keyword called **version** that is an opaque identifier/value (read that as string) of the current version of the respective individual resource. You can then use \"type\", \"id\", and \"version\" to uniquely identify a resource and at what version this representation is. I believe having the version be a known property on a json-api compliant resource further refines the \"identity\" of the resource and makes certain client-side workflows easier, i.e. optimistic locking, client-side caching, etc.\r\n"},"comment":{"url":"https://api.github.com/repos/json-api/json-api/issues/comments/124569349","html_url":"https://github.com/json-api/json-api/issues/600#issuecomment-124569349","issue_url":"https://api.github.com/repos/json-api/json-api/issues/600","id":124569349,"user":{"login":"steveklabnik","id":27786,"avatar_url":"https://avatars.githubusercontent.com/u/27786?v=3","gravatar_id":"","url":"https://api.github.com/users/steveklabnik","html_url":"https://github.com/steveklabnik","followers_url":"https://api.github.com/users/steveklabnik/followers","following_url":"https://api.github.com/users/steveklabnik/following{/other_user}","gists_url":"https://api.github.com/users/steveklabnik/gists{/gist_id}","starred_url":"https://api.github.com/users/steveklabnik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/steveklabnik/subscriptions","organizations_url":"https://api.github.com/users/steveklabnik/orgs","repos_url":"https://api.github.com/users/steveklabnik/repos","events_url":"https://api.github.com/users/steveklabnik/events{/privacy}","received_events_url":"https://api.github.com/users/steveklabnik/received_events","type":"User","site_admin":false},"created_at":"2015-07-24T16:09:40Z","updated_at":"2015-07-24T16:09:40Z","body":"Sorry, I think the \"real REST\" vs \"not real REST\" terminology is messing me up here.\r\n\r\nI am incredibly skeptical, but I may just be an old man here... "}}