@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Top Stories
@base http://api.nytimes.com/svc/topstories/v2
@version 2.0.0
@auth ApiKey api-key in query
@endpoints 1
@toc {section}.{format}(1)

@endpoint GET /{section}.{format}
@desc Top Stories
@required {section: any # The section the story appears in., format: any # if this is JSONP or JSON}
@optional {callback: any # The name of the function the API call results will be passed to. Required when using JSONP. This parameter has only one valid value per section. The format is {section_name}TopStoriesCallback.}
@returns(200) An array of articles

@end