@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Auckland Museum API
@base https://api.aucklandmuseum.com
@version 2.0.0
@endpoints 6
@toc search(2), id(2), sparql(2)

@group search
@endpoint GET /search/{index}/{operation}
@required {index: any, operation: any}
@optional {q: any}
@returns(200)
@errors {400, 404}

@endpoint POST /search/{index}/{operation}
@required {index: any, operation: any}
@optional {body: map}
@returns(200)
@errors {400, 404}

@endgroup

@group id
@endpoint GET /id/{identifier}
@required {identifier: any}
@returns(200)
@errors {404}

@endpoint GET /id/media/{path}
@required {path: any}
@optional {rendering: any}
@returns(200)
@errors {404}

@endgroup

@group sparql
@endpoint GET /sparql
@required {query: any}
@optional {callback: any, infer: any}
@returns(200)

@endpoint POST /sparql
@required {query: any}
@optional {infer: any}
@returns(200)

@endgroup

@end