{"note":"OpenAPI conversion -- returning structured metadata","name":"fungenerators-com-riddle","description":"Random Riddles API","version":"1.5","base_url":"https://api.fungenerators.com","endpoints":6,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Random Riddles API\n@base https://api.fungenerators.com\n@version 1.5\n@auth ApiKey X-Fungenerators-Api-Secret in header\n@endpoints 6\n@toc riddle(6)\n\n@endpoint GET /riddle\n@desc Get a Riddle entry for a given id. Retrieves a riddle question and answer based on the id.\n@optional {id: str(string) # ID of the riddle to fetch}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint POST /riddle\n@desc Create a random Riddle entry. Same as 'PUT' but can be used when some of the client libraries don't support 'PUT'.\n@required {question: str(string) # Riddle Question, category: str(string) # Category of the riddle, answer: str(string) # Answer(s) to the riddle question}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint PUT /riddle\n@desc Create a random Riddle entry.\n@required {question: str(string) # Riddle Question, category: str(string) # Category of the riddle, answer: str(string) # Answer(s) to the riddle question}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint DELETE /riddle\n@desc Create a random Riddle entry.\n@required {id: str(string) # Riddle ID}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /riddle/random\n@desc Get a random riddle for a given category(optional)\n@optional {category: str(string) # Category to get the riddle from}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /riddle/search\n@desc Search for random riddle which has the text in the query, for a given category(optional).\n@optional {query: str(string) # Text to search for in the riddle, category: str(string) # Category to get the riddle from}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@end\n"}