{"action":"opened","issue":{"url":"https://api.github.com/repos/EHRI/ehri-rest/issues/175","labels_url":"https://api.github.com/repos/EHRI/ehri-rest/issues/175/labels{/name}","comments_url":"https://api.github.com/repos/EHRI/ehri-rest/issues/175/comments","events_url":"https://api.github.com/repos/EHRI/ehri-rest/issues/175/events","html_url":"https://github.com/EHRI/ehri-rest/issues/175","id":107957697,"number":175,"title":"Improve the web service API...","user":{"login":"mikesname","id":871049,"avatar_url":"https://avatars.githubusercontent.com/u/871049?v=3","gravatar_id":"","url":"https://api.github.com/users/mikesname","html_url":"https://github.com/mikesname","followers_url":"https://api.github.com/users/mikesname/followers","following_url":"https://api.github.com/users/mikesname/following{/other_user}","gists_url":"https://api.github.com/users/mikesname/gists{/gist_id}","starred_url":"https://api.github.com/users/mikesname/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mikesname/subscriptions","organizations_url":"https://api.github.com/users/mikesname/orgs","repos_url":"https://api.github.com/users/mikesname/repos","events_url":"https://api.github.com/users/mikesname/events{/privacy}","received_events_url":"https://api.github.com/users/mikesname/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-09-23T16:29:04Z","updated_at":"2015-09-23T16:29:04Z","closed_at":null,"body":"Several things are nasty about the current RESTful API (not including the internally-specific graph-like data it returns):\r\n\r\n - item types are singular, not plural, e.g. `/ehri/documentaryUnit/{id}`\r\n - list endpoints have the form `/ehri/documentaryUnit/list`, where the `list` part can get confused (by clients) for an ID\r\n\r\nPerhaps change things to:\r\n\r\n - `/ehri/documentaryUnits` GET list\r\n - `/ehri/documentaryUnits` POST create\r\n - `/ehri/documentaryUnits/{id}` GET item\r\n - `/ehri/documentaryUnits/{id}/list` GET list nested items\r\n - `/ehri/documentaryUnits/{id}` PUT update\r\netc"}}