Swagger does a good job of this with a little help from decorators in Typescript