{"action":"created","issue":{"url":"https://api.github.com/repos/OpenTreeOfLife/germinator/issues/71","repository_url":"https://api.github.com/repos/OpenTreeOfLife/germinator","labels_url":"https://api.github.com/repos/OpenTreeOfLife/germinator/issues/71/labels{/name}","comments_url":"https://api.github.com/repos/OpenTreeOfLife/germinator/issues/71/comments","events_url":"https://api.github.com/repos/OpenTreeOfLife/germinator/issues/71/events","html_url":"https://github.com/OpenTreeOfLife/germinator/issues/71","id":143335775,"number":71,"title":"v3 collection methods","user":{"login":"kcranston","id":312034,"avatar_url":"https://avatars.githubusercontent.com/u/312034?v=3","gravatar_id":"","url":"https://api.github.com/users/kcranston","html_url":"https://github.com/kcranston","followers_url":"https://api.github.com/users/kcranston/followers","following_url":"https://api.github.com/users/kcranston/following{/other_user}","gists_url":"https://api.github.com/users/kcranston/gists{/gist_id}","starred_url":"https://api.github.com/users/kcranston/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kcranston/subscriptions","organizations_url":"https://api.github.com/users/kcranston/orgs","repos_url":"https://api.github.com/users/kcranston/repos","events_url":"https://api.github.com/users/kcranston/events{/privacy}","received_events_url":"https://api.github.com/users/kcranston/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-03-24T19:16:47Z","updated_at":"2016-03-24T19:57:43Z","closed_at":null,"body":"Looks like we did a bad job reviewing the [V3 spec for collections](https://docs.google.com/document/d/1XcgoQGJVxSgk-yKB-NAayQNZ2_QUQuw9_RIvbR2LeTw/edit#heading=h.yty047927s81). Some comments on the the methods listed:\r\n* find_collections : when called without parameters, returns all collections. No effect of the verbose setting (i.e. always returns the entire collection blob for all collections)\r\n* properties : not implemented (the [webapp does all filtering client-side](https://github.com/OpenTreeOfLife/opentree/blob/0340c0e7a35e527d13d95f529997cfc9f9f47a19/curator/static/js/tree-collection-dashboard.js))\r\n* collection : works as described, e.g. `$ curl https://devapi.opentreeoflife.org/v3/collection/jimallman/asdf` \r\n\r\nI propose that we document only the existing functionality, or leave this undocumented for v3. Ideally for v4, it would be nice to implement find as GET with URL parameters (i.e. it seems silly to re-use the POST hacks that we have for studies with collections, since collections don't use the technology (neo4j) that makes these hacks necessary). \r\n\r\nThoughts? @jar398 @jimallman \r\n"},"comment":{"url":"https://api.github.com/repos/OpenTreeOfLife/germinator/issues/comments/200993436","html_url":"https://github.com/OpenTreeOfLife/germinator/issues/71#issuecomment-200993436","issue_url":"https://api.github.com/repos/OpenTreeOfLife/germinator/issues/71","id":200993436,"user":{"login":"jimallman","id":446375,"avatar_url":"https://avatars.githubusercontent.com/u/446375?v=3","gravatar_id":"","url":"https://api.github.com/users/jimallman","html_url":"https://github.com/jimallman","followers_url":"https://api.github.com/users/jimallman/followers","following_url":"https://api.github.com/users/jimallman/following{/other_user}","gists_url":"https://api.github.com/users/jimallman/gists{/gist_id}","starred_url":"https://api.github.com/users/jimallman/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jimallman/subscriptions","organizations_url":"https://api.github.com/users/jimallman/orgs","repos_url":"https://api.github.com/users/jimallman/repos","events_url":"https://api.github.com/users/jimallman/events{/privacy}","received_events_url":"https://api.github.com/users/jimallman/received_events","type":"User","site_admin":false},"created_at":"2016-03-24T19:57:43Z","updated_at":"2016-03-24T19:57:43Z","body":"I _do_ think the existing methods are useful for API consumers, so I'd prefer to document this before too long. It's just a question of how much we intend to refine them, and whether API revisions will cause more annoyance than simply waiting until this is more mature."}}