Why was this project needed? Honestly it wasn't, but I had a ton of fun making it, and I really hope you enjoy using it. This API doesn't require authentication to use, but please be reasonable with usage. All requests will return a json response based on the parameters you have passed to the server.
To retrieve a random joke from the server, you need to perform a get request to the following endpoint.
curl -X 'GET' \ 'https://www.yomama-jokes.com/api/v1/jokes/random/' \ -H 'accept: application/json'
/api/v1/jokes/random/
The response will contain a joke and category.
{ "joke": "string", "category": "string" }
To retrieve a random joke by category from the server, you need to perform a get request to the following endpoint with a category.
curl -X 'GET' \ 'https://www.yomama-jokes.com/api/v1/jokes/category/random/' \ -H 'accept: application/json'
/api/v1/jokes/category/random/
The categories available are "fat", "stupid", "ugly", "nasty", "hairy", "bald", "old", "poor", "short", "skinny", or "tall". Anything else will return a 404 not found error.
The response will contain a joke and category.
{ "joke": "string", "category": "string" }
To retrieve a random joke list by category from the server, you need to perform a get request to the following endpoint with a category.
curl -X 'GET' \ 'https://www.yomama-jokes.com/api/v1/jokes/category/' \ -H 'accept: application/json'
/api/v1/jokes/category/
The categories available are "fat", "stupid", "ugly", "nasty", "hairy", "bald", "old", "poor", "short", "skinny", or "tall". Anything else will return a 404 not found error.
The response an array of jokes that all contain a joke, and category.
[{ "joke": "string", "category": "string" }, ... ]