Comment by bryan_cooper

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