@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Random Lovecraft
@base https://randomlovecraft.com/api
@version 1.0
@endpoints 4
@toc sentences(2), books(2)

@group sentences
@endpoint GET /sentences
@desc A random sentence
@returns(200) {data: [map]}

@endpoint GET /sentences/{id}
@desc A specific sentence
@returns(200) {data: map{id: str, sentence: str, book: map{id: str, name: str, year: str}}}

@endgroup

@group books
@endpoint GET /books/{id}/sentences
@desc Random sentences from a specific book
@returns(200) {data: [map]}

@endpoint GET /books
@desc List all books
@returns(200) {data: [map]}

@endgroup

@end