openapi-directory/api/fungenerators.com/taunt.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","info":{"contact":{"name":"Fun Generators","url":"http://fungenerators.com/"},"description":"Fungenerators taunt generation API generates random taunts / insults,  relevant to the given category. Many categories are supported and new ones are added very frequently. [Click here to subscribe](http://fungenerators.com/api/taunt/)\n","termsOfService":"https://fungenerators.com/terms","title":"Taunt as a service","version":"1.5","x-apisguru-categories":["text"],"x-origin":[{"format":"swagger","url":"https://fungenerators.com/yaml/taunt.yaml","version":"2.0"}],"x-providerName":"fungenerators.com","x-serviceName":"taunt"},"tags":[{"description":"Taunt Generation API","externalDocs":{"description":"Find out more","url":"http://fungenerators.com/api/taunt/"},"name":"Taunt"}],"paths":{"/taunt/categories":{"get":{"description":"Get available taunt generation categories.","parameters":[{"description":"start","in":"query","name":"start","required":false,"schema":{"type":"integer","format":"integer"}},{"description":"limit","in":"query","name":"limit","required":false,"schema":{"type":"integer","format":"integer"}}],"responses":{"200":{"description":"200  response","content":{"application/json":{"examples":{"response":{"value":"{\n  \"success\": {\n    \"total\": \"7\",\n    \"start\": 0,\n    \"limit\": 10\n  },\n  \"contents\": [\n    [\n      {\n        \"name\": \"new-age-insult\",\n        \"title\": \"Random Insult Generator\",\n        \"description\": \"Nothing personal mate! Just for fun! This is not appropriate for children!\"\n      },\n      {\n        \"name\": \"shakespeare\",\n        \"title\": \"Random Shakespearean Curse Generator\",\n        \"description\": \"Generates a random Shakespeare sounding curse every-time you visit the page. Cursing is bad for health ;) , use it only when necessary.\"\n      },\n      {\n        \"name\": \"lutheran-insult\",\n        \"title\": \"Random Lutheran Insult Generator\",\n        \"description\": \"Let Luther insult you from the history! These insults directly from the books of Luther will make you feel like the real Hanswursts - blockheads, boors, and dunderheads.\"\n      },\n      {\n        \"name\": \"scottish\",\n        \"title\": \"Random Scottish Insult Generator\",\n        \"description\": \"If you are insulting someone insult like Scot! Our Scottish insult generator will be your mate and do most of job for you!\"\n      },\n      {\n        \"name\": \"pirate-insult\",\n        \"title\": \"Pirate Insult Generator\",\n        \"description\": \"If you are insulting someone insult like Pirate! Our Pirate insult generator will make you a weasel hearted worm suckin' spineless bastitch !\"\n      },\n      {\n        \"name\": \"conservative-insult\",\n        \"title\": \"Conservative Insult Generator\",\n        \"description\": \"If you are in a political argument and need to insult the conservative on the other side in a hurry, our conservative insult generator will do the job for you!\"\n      },\n      {\n        \"name\": \"liberal-insult\",\n        \"title\": \"Liberal Insult Generator\",\n        \"description\": \"If you are in a political argument and need to insult the liberal on the other side in a hurry, our liberal insult generator will do the job for you!\"\n      }\n    ]\n  ]\n}"}}}}},"401":{"description":"401  response","content":{"application/json":{"examples":{"response":{"value":"{\n    \"error\": {\n        \"code\": 401,\n        \"message\": \"Unauthorized\"\n    }\n}     "}}}}}},"security":[{"X-Fungenerators-Api-Secret":[]}],"tags":["Taunt"]}},"/taunt/generate":{"get":{"description":"Generated taunts in the given category","parameters":[{"description":"Category to generator taunt from","in":"query","name":"category","required":true,"schema":{"type":"string","format":"string"}},{"description":"Limit. Controls number of taunts generated. Max of 5-10 based on the plan","in":"query","name":"limit","required":false,"schema":{"type":"integer","format":"integer"}}],"responses":{"200":{"description":"200  response","content":{"application/json":{"examples":{"response":{"value":"{\n  \"success\": {\n    \"total\": null,\n    \"limit\": 3\n  },\n  \"contents\": {\n    \"category\": \"shakespeare\",\n    \"taunts\": [\n      \"Thou infectious hasty-witted mammet!\",\n      \"Thou distempered iron-witted fustilarian!\",\n      \"Thou reeky ill-breeding scullion!\"\n    ]\n  },\n  \"copyright\": \"https://fungenerators.com/\"\n}"}}}}},"401":{"description":"401  response","content":{"application/json":{"examples":{"response":{"value":"{\n    \"error\": {\n        \"code\": 401,\n        \"message\": \"Unauthorized\"\n    }\n}"}}}}}},"security":[{"X-Fungenerators-Api-Secret":[]}],"tags":["Taunt"]}}},"servers":[{"url":"https://api.fungenerators.com"},{"url":"http://api.fungenerators.com"}],"components":{"securitySchemes":{"X-Fungenerators-Api-Secret":{"in":"header","name":"X-Fungenerators-Api-Secret","type":"apiKey"}}}}