{"action":"opened","issue":{"url":"https://api.github.com/repos/chadxz/my-api/issues/5","labels_url":"https://api.github.com/repos/chadxz/my-api/issues/5/labels{/name}","comments_url":"https://api.github.com/repos/chadxz/my-api/issues/5/comments","events_url":"https://api.github.com/repos/chadxz/my-api/issues/5/events","html_url":"https://github.com/chadxz/my-api/issues/5","id":58546171,"number":5,"title":"add new api version for cleaner responses","user":{"login":"chadxz","id":309219,"avatar_url":"https://avatars.githubusercontent.com/u/309219?v=3","gravatar_id":"","url":"https://api.github.com/users/chadxz","html_url":"https://github.com/chadxz","followers_url":"https://api.github.com/users/chadxz/followers","following_url":"https://api.github.com/users/chadxz/following{/other_user}","gists_url":"https://api.github.com/users/chadxz/gists{/gist_id}","starred_url":"https://api.github.com/users/chadxz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chadxz/subscriptions","organizations_url":"https://api.github.com/users/chadxz/orgs","repos_url":"https://api.github.com/users/chadxz/repos","events_url":"https://api.github.com/users/chadxz/events{/privacy}","received_events_url":"https://api.github.com/users/chadxz/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-02-23T06:05:37Z","updated_at":"2015-02-23T06:05:37Z","closed_at":null,"body":"Currently the api responses are pretty much exactly what is given back by the original API. One of the benefits of proxying these apis is the opportunity to cleanup these responses and give the data back in a format that is easier to consume in the target application. I'd like to setup a new version of the API that gives back an easier to digest format for the pinboard bookmarks and the lastfm tracks. namely:\r\n\r\nfor all:\r\n - give each \"item\" a unique id\r\n - make all dates returned by the api the same format (i.e. all unix timestamps)\r\n\r\nfor last.fm tracks:\r\n - build artist url automatically and include in track representation\r\n - put \"now playing\" in a less strange field\r\n - remove excess fields\r\n\r\nfor pinboard bookmarks:\r\n - remove excess fields\r\n\r\nthere may be more things, but this is a start. I haven't decided exactly how best to handle the multiple versions, but I think using an accept header is good enough, with the default being the newest version. The storage format can remain the same, and the results can be built then cached. When new data is available, the cache can be invalidated."}}