@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Most Popular API
@base http://api.nytimes.com/svc/mostpopular/v2
@version 2.0.0
@auth ApiKey api-key in query
@endpoints 3
@toc mostshared(1), mostemailed(1), mostviewed(1)

@group mostshared
@endpoint GET /mostshared/{section}/{time-period}.json
@desc Most Shared by Section & Time Period
@returns(200) An array of Articles
@errors {400}

@endgroup

@group mostemailed
@endpoint GET /mostemailed/{section}/{time-period}.json
@desc Most Emailed by Section & Time Period
@returns(200) An array of Articles
@errors {400, 403}

@endgroup

@group mostviewed
@endpoint GET /mostviewed/{section}/{time-period}.json
@desc Most Viewed by Section & Time Period
@returns(200) An array of Articles

@endgroup

@end