@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Facts API
@base https://api.fungenerators.com
@version 1.5
@auth Bearer bearer
@endpoints 12
@toc fact(12)

@endpoint GET /fact
@optional {id: str(string)}
@returns(200)
@errors {401}

@endpoint PUT /fact
@required {fact: str(string), category: str(string), subcategory: str(string), tags: str(string)}
@returns(200)
@errors {401}

@endpoint DELETE /fact
@required {id: str(string)}
@returns(200)
@errors {401}

@endpoint GET /fact/fod/categories
@returns(200)
@errors {401}

@endpoint GET /fact/fod
@optional {category: str(string)}
@returns(200)
@errors {401}

@endpoint GET /fact/random
@optional {category: str(string), subcategory: str(string)}
@returns(200)
@errors {401}

@endpoint GET /fact/search
@optional {query: str(string), category: str(string), subcategory: str(string)}
@returns(200)
@errors {401}

@endpoint GET /fact/categories
@optional {start: int(integer)}
@returns(200)
@errors {401}

@endpoint GET /fact/numbers
@required {number: int(integer)}
@returns(200)
@errors {401}

@endpoint GET /fact/onthisday/born
@optional {month: str(string), day: str(string)}
@returns(200)
@errors {401}

@endpoint GET /fact/onthisday/died
@optional {month: str(string), day: str(string)}
@returns(200)
@errors {401}

@endpoint GET /fact/onthisday/event
@optional {month: str(string), day: str(string)}
@returns(200)
@errors {401}

@end