{"action":"opened","issue":{"url":"https://api.github.com/repos/ga4gh/schemas/issues/326","labels_url":"https://api.github.com/repos/ga4gh/schemas/issues/326/labels{/name}","comments_url":"https://api.github.com/repos/ga4gh/schemas/issues/326/comments","events_url":"https://api.github.com/repos/ga4gh/schemas/issues/326/events","html_url":"https://github.com/ga4gh/schemas/issues/326","id":86659089,"number":326,"title":"Add response navigational fields","user":{"login":"wstidolph","id":65572,"avatar_url":"https://avatars.githubusercontent.com/u/65572?v=3","gravatar_id":"","url":"https://api.github.com/users/wstidolph","html_url":"https://github.com/wstidolph","followers_url":"https://api.github.com/users/wstidolph/followers","following_url":"https://api.github.com/users/wstidolph/following{/other_user}","gists_url":"https://api.github.com/users/wstidolph/gists{/gist_id}","starred_url":"https://api.github.com/users/wstidolph/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wstidolph/subscriptions","organizations_url":"https://api.github.com/users/wstidolph/orgs","repos_url":"https://api.github.com/users/wstidolph/repos","events_url":"https://api.github.com/users/wstidolph/events{/privacy}","received_events_url":"https://api.github.com/users/wstidolph/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-06-09T16:34:50Z","updated_at":"2015-06-09T16:34:50Z","closed_at":null,"body":"The schema should include navigational mechanisms in responses. As a client, I want to know how many items are in the total response, and I want to be able to fetch a page (of arbitrary size) starting at any offset in the range.\r\n\r\nMy immediate example is wanting to keep validation testing snappy ... trying to validate the size of a response, apparently I have to page through the set and count entities on each page. And when I want to do sample-testing to validate data/ordering constraints I'd like to grab data from selected sub-items of the response\r\n\r\nThis is useful not only as metadata for testing and general navigation, but in a data server it seems that's useful as actual data - the result set size answers \"how many X fit the criteria of Y\" even without returning the actual data."}}