{"action":"created","issue":{"url":"https://api.github.com/repos/openreferral/api-specification/issues/22","repository_url":"https://api.github.com/repos/openreferral/api-specification","labels_url":"https://api.github.com/repos/openreferral/api-specification/issues/22/labels{/name}","comments_url":"https://api.github.com/repos/openreferral/api-specification/issues/22/comments","events_url":"https://api.github.com/repos/openreferral/api-specification/issues/22/events","html_url":"https://github.com/openreferral/api-specification/issues/22","id":230236709,"number":22,"title":"Search URLs vs params","user":{"login":"switzersc","id":3752314,"avatar_url":"https://avatars1.githubusercontent.com/u/3752314?v=4","gravatar_id":"","url":"https://api.github.com/users/switzersc","html_url":"https://github.com/switzersc","followers_url":"https://api.github.com/users/switzersc/followers","following_url":"https://api.github.com/users/switzersc/following{/other_user}","gists_url":"https://api.github.com/users/switzersc/gists{/gist_id}","starred_url":"https://api.github.com/users/switzersc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/switzersc/subscriptions","organizations_url":"https://api.github.com/users/switzersc/orgs","repos_url":"https://api.github.com/users/switzersc/repos","events_url":"https://api.github.com/users/switzersc/events{/privacy}","received_events_url":"https://api.github.com/users/switzersc/received_events","type":"User","site_admin":false},"labels":[{"id":584025996,"url":"https://api.github.com/repos/openreferral/api-specification/labels/design","name":"design","color":"5319e7","default":false},{"id":580927728,"url":"https://api.github.com/repos/openreferral/api-specification/labels/road%20map","name":"road map","color":"0e8a16","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":9,"created_at":"2017-05-21T17:56:05Z","updated_at":"2017-08-10T16:08:57Z","closed_at":null,"body":"IMO, search URLs are always tough. Right now, the search URL in the Ohana API I've seen is a bit confusing because I don’t know what kind of resource it will return. Will it return `locations`, or `organizations`, or any type of resource that fits the keyword? Also, a `search` isn’t a resource exactly, so having it in the URL doesn’t feel very RESTy (although arguably this doesn’t matter much). My convention would be to just add those search params to the `/locations` endpoint, unless the search action is meant to return multiple resources, in which case I think a dedicated `search` URL is appropriate.\r\n\r\nOn this note, is it necessary to have an endpoint for `/locations/nearby` when that URL accepts params anyway? Thoughts on just allowing those possible params on the `/locations` endpoint instead of dedicating a separate endpoint for it?"},"comment":{"url":"https://api.github.com/repos/openreferral/api-specification/issues/comments/321598122","html_url":"https://github.com/openreferral/api-specification/issues/22#issuecomment-321598122","issue_url":"https://api.github.com/repos/openreferral/api-specification/issues/22","id":321598122,"user":{"login":"NeilMcKechnie","id":8440886,"avatar_url":"https://avatars2.githubusercontent.com/u/8440886?v=4","gravatar_id":"","url":"https://api.github.com/users/NeilMcKechnie","html_url":"https://github.com/NeilMcKechnie","followers_url":"https://api.github.com/users/NeilMcKechnie/followers","following_url":"https://api.github.com/users/NeilMcKechnie/following{/other_user}","gists_url":"https://api.github.com/users/NeilMcKechnie/gists{/gist_id}","starred_url":"https://api.github.com/users/NeilMcKechnie/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/NeilMcKechnie/subscriptions","organizations_url":"https://api.github.com/users/NeilMcKechnie/orgs","repos_url":"https://api.github.com/users/NeilMcKechnie/repos","events_url":"https://api.github.com/users/NeilMcKechnie/events{/privacy}","received_events_url":"https://api.github.com/users/NeilMcKechnie/received_events","type":"User","site_admin":false},"created_at":"2017-08-10T16:08:57Z","updated_at":"2017-08-10T16:08:57Z","body":"I agree we need a \"general\" search for all the reasons stated above. Also the searcher may not be sure in which object type they may find the search term. \"Saint Mary's Church\" could be the name of an Organization, Location and/or Service. Heck it could also just be part of an Address, or the name of a Phone Number. Imagine how much fun it would be (not!) poking at every object type individually with API calls and trying to blend the results back together yourself. Yuck."}}
{"actor":{"display_login":"NeilMcKechnie"}}