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

- cleanup reference api.json some and add types for path params