{"action":"created","issue":{"url":"https://api.github.com/repos/openzipkin/zipkin/issues/1002","repository_url":"https://api.github.com/repos/openzipkin/zipkin","labels_url":"https://api.github.com/repos/openzipkin/zipkin/issues/1002/labels{/name}","comments_url":"https://api.github.com/repos/openzipkin/zipkin/issues/1002/comments","events_url":"https://api.github.com/repos/openzipkin/zipkin/issues/1002/events","html_url":"https://github.com/openzipkin/zipkin/issues/1002","id":136018502,"number":1002,"title":"Package api docs on zipkin-query-service","user":{"login":"adriancole","id":64215,"avatar_url":"https://avatars.githubusercontent.com/u/64215?v=3","gravatar_id":"","url":"https://api.github.com/users/adriancole","html_url":"https://github.com/adriancole","followers_url":"https://api.github.com/users/adriancole/followers","following_url":"https://api.github.com/users/adriancole/following{/other_user}","gists_url":"https://api.github.com/users/adriancole/gists{/gist_id}","starred_url":"https://api.github.com/users/adriancole/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adriancole/subscriptions","organizations_url":"https://api.github.com/users/adriancole/orgs","repos_url":"https://api.github.com/users/adriancole/repos","events_url":"https://api.github.com/users/adriancole/events{/privacy}","received_events_url":"https://api.github.com/users/adriancole/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-02-24T10:28:41Z","updated_at":"2016-02-24T10:30:58Z","closed_at":null,"body":"It would be nice to host the openapi docs on the query server, so people using it can discover how to use the api. I suspect there will be steps to take in multiple repos, and decisions to make.\r\n\r\nProbably we want to package a jar, so that existing apps can import them. For example add the api docs under, `META-INF/resources/api/v1` to match servlet-style resource mappings.\r\n\r\nEx. if we had this, you could go to http://zipkinquery:9411/api/v1 in the browser, which would look like http://openzipkin.github.io/zipkin-api/#/\r\n\r\nWe'd want to be careful not to intrude on the efforts to re-host the zipkin javascript UI onto the query server."},"comment":{"url":"https://api.github.com/repos/openzipkin/zipkin/issues/comments/188183479","html_url":"https://github.com/openzipkin/zipkin/issues/1002#issuecomment-188183479","issue_url":"https://api.github.com/repos/openzipkin/zipkin/issues/1002","id":188183479,"user":{"login":"eirslett","id":1872593,"avatar_url":"https://avatars.githubusercontent.com/u/1872593?v=3","gravatar_id":"","url":"https://api.github.com/users/eirslett","html_url":"https://github.com/eirslett","followers_url":"https://api.github.com/users/eirslett/followers","following_url":"https://api.github.com/users/eirslett/following{/other_user}","gists_url":"https://api.github.com/users/eirslett/gists{/gist_id}","starred_url":"https://api.github.com/users/eirslett/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eirslett/subscriptions","organizations_url":"https://api.github.com/users/eirslett/orgs","repos_url":"https://api.github.com/users/eirslett/repos","events_url":"https://api.github.com/users/eirslett/events{/privacy}","received_events_url":"https://api.github.com/users/eirslett/received_events","type":"User","site_admin":false},"created_at":"2016-02-24T10:30:58Z","updated_at":"2016-02-24T10:30:58Z","body":"That should work well together with the javascript UI. As long as every API call is under /api/v1, then we can return assets for all other endpoints.\r\n"}}