{"action":"created","issue":{"url":"https://api.github.com/repos/codeforkansascity/address-api/issues/89","repository_url":"https://api.github.com/repos/codeforkansascity/address-api","labels_url":"https://api.github.com/repos/codeforkansascity/address-api/issues/89/labels{/name}","comments_url":"https://api.github.com/repos/codeforkansascity/address-api/issues/89/comments","events_url":"https://api.github.com/repos/codeforkansascity/address-api/issues/89/events","html_url":"https://github.com/codeforkansascity/address-api/pull/89","id":153018853,"number":89,"title":"Adding Swagger documentation","user":{"login":"buzwells","id":1810471,"avatar_url":"https://avatars.githubusercontent.com/u/1810471?v=3","gravatar_id":"","url":"https://api.github.com/users/buzwells","html_url":"https://github.com/buzwells","followers_url":"https://api.github.com/users/buzwells/followers","following_url":"https://api.github.com/users/buzwells/following{/other_user}","gists_url":"https://api.github.com/users/buzwells/gists{/gist_id}","starred_url":"https://api.github.com/users/buzwells/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/buzwells/subscriptions","organizations_url":"https://api.github.com/users/buzwells/orgs","repos_url":"https://api.github.com/users/buzwells/repos","events_url":"https://api.github.com/users/buzwells/events{/privacy}","received_events_url":"https://api.github.com/users/buzwells/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2016-05-04T13:58:51Z","updated_at":"2016-05-05T14:16:27Z","closed_at":"2016-05-04T20:52:55Z","pull_request":{"url":"https://api.github.com/repos/codeforkansascity/address-api/pulls/89","html_url":"https://github.com/codeforkansascity/address-api/pull/89","diff_url":"https://github.com/codeforkansascity/address-api/pull/89.diff","patch_url":"https://github.com/codeforkansascity/address-api/pull/89.patch"},"body":"I've added a starter Swagger documentation file and the Swagger UI distribution. To make the UI accessible locally at http://dev-api.codeforkc.local/api-docs/, I added a symlink in webroot and modified the bootstrap.sh file to recognize index.html as a secondary but valid directory index. I also added a script (/data/scripts/fix_permissions.psql) to make it easier to fix permissions on setup. Simply navigate to /var/www/data/scripts on the vagrant box (within postgres) and issue the command \"psql -f fix_permissions.psql\". You'll have to key through a couple of pauses, but it's simpler than typing all the permission fixes in.\r\n\r\nNot all of the endpoints have been documented. And many of the fields lack definitions. But this is hopefully a decent start.\r\n\r\nNote: it appears that a column (land_bank_property) has been added to the Address.php base select but is not yet reflected in the db dumps. In order to make my calls work for testing the Swagger UI, I simply commented that column out of the select. But I thought I would pass that info along.\r\n\r\nIf this does not fit the vision for how to incorporate Swagger into the project, just let me know what you would like me to change. Thanks!"},"comment":{"url":"https://api.github.com/repos/codeforkansascity/address-api/issues/comments/217165990","html_url":"https://github.com/codeforkansascity/address-api/pull/89#issuecomment-217165990","issue_url":"https://api.github.com/repos/codeforkansascity/address-api/issues/89","id":217165990,"user":{"login":"buzwells","id":1810471,"avatar_url":"https://avatars.githubusercontent.com/u/1810471?v=3","gravatar_id":"","url":"https://api.github.com/users/buzwells","html_url":"https://github.com/buzwells","followers_url":"https://api.github.com/users/buzwells/followers","following_url":"https://api.github.com/users/buzwells/following{/other_user}","gists_url":"https://api.github.com/users/buzwells/gists{/gist_id}","starred_url":"https://api.github.com/users/buzwells/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/buzwells/subscriptions","organizations_url":"https://api.github.com/users/buzwells/orgs","repos_url":"https://api.github.com/users/buzwells/repos","events_url":"https://api.github.com/users/buzwells/events{/privacy}","received_events_url":"https://api.github.com/users/buzwells/received_events","type":"User","site_admin":false},"created_at":"2016-05-05T14:16:27Z","updated_at":"2016-05-05T14:16:27Z","body":"New pull request is at https://github.com/codeforkansascity/address-api/pull/90"}}