@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Movie Reviews API
@base http://api.nytimes.com/svc/movies/v2
@version 2.0.0
@auth ApiKey api-key in query
@endpoints 3
@toc reviews(2), critics(1)

@group reviews
@endpoint GET /reviews/{resource-type}.json
@required {resource-type: any}
@optional {offset: any, order: any}
@returns(200)

@endpoint GET /reviews/search.json
@optional {query: any, critics-pick: any, reviewer: any, publication-date: any, opening-date: any, offset: any, order: any}
@returns(200)

@endgroup

@group critics
@endpoint GET /critics/{resource-type}.json
@required {resource-type: any}
@returns(200)

@endgroup

@end