adding an option to flag an api route as deprecated

if this flag is present, it adds an annotation to the route in the
api documentation
Merge pull request #268 from komidore64/deprecated-route-flag

adding an option to flag an api route as deprecated