specs for generated apis

and proper packaging
Merge pull request #37 from ckampfe/spec_for_generated_apis

initial specs for generated apis