@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
@returns(200) {data: [map]}

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

@endgroup

@group books
@endpoint GET /books/{id}/sentences
@returns(200) {data: [map]}

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

@endgroup

@end