@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Shakespeare API
@base http://api.fungenerators.com
@version 1.5
@auth ApiKey X-Fungenerators-Api-Secret in header
@endpoints 5
@toc shakespeare(5)

@endpoint GET /shakespeare/generate/name
@desc Generate random Shakespearen names.
@optional {variation: str(string) # Variation to generate `male/female`., limit: int(integer) # No of names to generate}
@returns(200) 200  response
@errors {401: 401  response}

@endpoint GET /shakespeare/generate/insult
@desc Generate random Shakespeare style insults.
@optional {limit: int(integer) # No of insults to generate}
@returns(200) 200  response
@errors {401: 401  response}

@endpoint GET /shakespeare/generate/lorem-ipsum
@desc Generate Shakespeare lorem ipsum.
@optional {type: str(string) # Type of element to generate `paragraphs/sentences/words`., limit: int(integer) # No of elements to generate}
@returns(200) 200  response
@errors {401: 401  response}

@endpoint GET /shakespeare/translate
@desc Translate from English to Shakespeare English.
@required {text: str(string) # Text to translate to Shakespeare English.}
@returns(200) 200  response
@errors {401: 401  response}

@endpoint GET /shakespeare/quote
@desc Get a random Shakespeare quote.
@returns(200) 200  response
@errors {401: 401  response}

@end