ISSUE-14: use java.util.UUID in generated routes

- cleanup reference api.json some and add types for path params
Merge pull request #35 from gilt/issue-14

ISSUE-14: use java.util.UUID in generated routes