add open api spec to all rest modules

[jschmidtnj]

• https://github.com/thiagobustamante/typescript-rest-swagger
• https://github.com/thiagobustamante/typescript-rest
• https://github.com/manifoldco/swagger-to-ts
• alternative (not currently being used): https://github.com/mtennoe/swagger-typescript-codegen
• https://aiohttp-swagger.readthedocs.io/en/latest/quick_start.html

[jschmidtnj]

ended up using this instead for python swagger: https://github.com/hh-h/aiohttp-swagger3

[jschmidtnj]

java / python client code gen: https://github.com/swagger-api/swagger-codegen (will probably not be necessary, unless requests to the api are needed during analysis)

[jschmidtnj]

java swagger annotations: https://github.com/swagger-api/swagger-core/wiki/Swagger-2.X---Getting-started#quick-start

[jschmidtnj]

python is done, java is not done (yet)