{"note":"OpenAPI conversion -- returning structured metadata","name":"fungenerators-com-random-facts","description":"Facts API","version":"1.5","base_url":"https://api.fungenerators.com","endpoints":12,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Facts API\n@base https://api.fungenerators.com\n@version 1.5\n@auth Bearer bearer\n@endpoints 12\n@toc fact(12)\n\n@endpoint GET /fact\n@desc Get a Fact belonging to the id.\n@optional {id: str(string) # ID of the fact to fetch}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint PUT /fact\n@desc Add a Fact entry to the database (private collection).\n@required {fact: str(string) # Fact Text, category: str(string) # Category of the fact, subcategory: str(string) # Sub Category of the fact, tags: str(string) # Tags}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint DELETE /fact\n@desc Delete a Fact entry identified by the id.\n@required {id: str(string) # Fact ID}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/fod/categories\n@desc Get the list of supported fact of the day categories.\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/fod\n@desc Get fact of the day for the given category.\n@optional {category: str(string) # Category to get the fact of the day from. Must be one from the list returned from /fact/fod/categories}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/random\n@desc Get a random Fact for a given category(optional) and subcategory(optional).\n@optional {category: str(string) # Category to get the fact from, subcategory: str(string) # Sub Category to get the fact from}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/search\n@desc Search for random Fact which has the text in the query, for a given category(optional) and subcategory(optional).\n@optional {query: str(string) # Text to search for in the facts, category: str(string) # Category to get the fact from, subcategory: str(string) # Sub Category to get the fact from}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/categories\n@desc Get a random Fact.\n@optional {start: int(integer) # start}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/numbers\n@desc Get a random fact about a number\n@required {number: int(integer) # Number value}\n@returns(200) 200 Success response\n@errors {401: 401 Unauthorized response}\n\n@endpoint GET /fact/onthisday/born\n@desc Returns a random ( famous/ relatively famous ) person born on a given day and month\n@optional {month: str(string) # Optional month (1-12). Defaults to current month, day: str(string) # Optional day of the month (1- 28/30/31 based on the month). Defaults to current day of the month.}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/onthisday/died\n@desc Returns a random ( famous/ relatively famous ) person died on a given day and month\n@optional {month: str(string) # Optional month (1-12). Defaults to current month, day: str(string) # Optional day of the month (1- 28/30/31 based on the month). Defaults to current day of the month.}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/onthisday/event\n@desc Returns a random ( famous/ relatively famous ) historic event on a given day and month\n@optional {month: str(string) # Optional month (1-12). Defaults to current month, day: str(string) # Optional day of the month (1- 28/30/31 based on the month). Defaults to current day of the month.}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@end\n"}