@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Times Newswire API
@base http://api.nytimes.com/svc/news/v3
@version 3.0.0
@auth ApiKey api-key in query
@endpoints 3
@toc content(2), content.json(1)

@group content
@endpoint GET /content/{source}/{section}.json
@required {source: any, section: any}
@optional {limit: any, offset: any}
@returns(200)

@endpoint GET /content/{source}/{section}/{time-period}.json
@required {source: any, section: any, time-period: any}
@optional {limit: any, offset: any}
@returns(200)

@endgroup

@group content.json
@endpoint GET /content.json
@required {url: any}
@returns(200)

@endgroup

@end